編輯

copilotPackageActivationResult resource type

This reference describes only the beta contract. Select beta to view it; availability depends on the matching schema and backend release.

Important

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

The value returned by successful Activate requests. It records attempted stages, not creation of an agent instance, an effective-version pin, or a transaction.

Non-2xx responses use a separate Graph error envelope; they don't return this composite's packageId, status, or steps. Failed source outcomes retained in the type are not successful Graph action responses.

Methods

None.

Properties

Property Type Description
error copilotPackageActivationError Nullable. Retained workflow-error shape. Not populated as a root property on the normal successful Graph response; transport failures use the error envelope instead.
packageId String Nullable. Echo of the route's package identifier, not a discovered post-approval ID or effective activated version.
status copilotPackageActivationStatus Non-nullable. Overall workflow result. Inspect step and per-policy details even for a successful warning response.
steps copilotPackageActivationStep collection Non-nullable. Attempted steps in attempt order; an absent stage isn't evidence it succeeded.

copilotPackageActivationStatus enumeration

Value Description
succeeded The workflow reported success.
succeededWithWarnings The workflow continued with an eligible warning, such as tolerated policy failure.
failed Failure value retained for source-model parity; the normal Graph path uses a non-2xx error envelope rather than returning a successful composite with this status.
unknownFutureValue Reserved for enum evolution.

Relationships

None.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.copilotPackageActivationResult",
  "error": {
    "@odata.type": "microsoft.graph.copilotPackageActivationError"
  },
  "packageId": "String",
  "status": "String",
  "steps": [
    {
      "@odata.type": "microsoft.graph.copilotPackageActivationStep"
    }
  ]
}