Edit

copilotPackagePublishPrincipal resource type

Important

APIs under the /beta version are subject to change. Use of these APIs in production applications is not supported.

Represents an explicit member of the principals collection in copilotPackagePublishScope.

The optional copilotPackageInstallScope reuses this shape but accepts only validated user and group object GUIDs. Broader publication vocabulary doesn't establish support for other installation recipients.

For a user or group audience, use its source object identifier with the public type user or group, not a display name or contact address. Publish preserves opaque nonblank identifiers; naming a principal type doesn't convert its ID or establish an application-ID versus object-ID equivalence. The read-side request principal vocabulary is separate.

Methods

None.

Properties

Property Type Description
id String Required and non-nullable. Opaque nonblank source principal identifier, preserved without rewriting. Installation separately restricts user/group IDs to nonzero hyphenated GUIDs.
type copilotPackagePublishPrincipalType Required and non-nullable. Public principal vocabulary below. Undefined or combined values aren't accepted.

copilotPackagePublishPrincipalType enumeration

Value Description
unknown The source's unclassified principal kind; doesn't establish target support for a particular scenario.
user A user principal.
group A group principal.
agentIdentity An agent-identity principal. Use its existing source identifier; selecting this kind doesn't resolve or replace an identifier.
agentUser An agent-user principal kind.
unknownFutureValue Reserved for enum evolution; not a valid request value and not the same as unknown.

The separate read-side agentApplication value is unchanged. This proposed typed beta input requires matching backend qualification; declaration alone isn't admission.

Relationships

None.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.copilotPackagePublishPrincipal",
  "id": "String",
  "type": "String"
}