AGagentarea
v1
protected
bundles

Install Bundle

Changed on

Install a canonical bundle: MCP instances, skills, agents and automations.

A bundle installed here before is redeployed: what it created is updated in place where the plan says so, and what it no longer declares is kept. All or nothing: a failure removes whatever this install had created. A plan other than the one plan_digest names answers 409 (code: bundle_plan_changed) and writes nothing. A bundle or setup value that is invalid answers 422 (code: bundle_invalid); any other install failure answers 400 (code: bundle_install_failed). All are problem+json with the message in detail and the blocking issues.

post/v1/workspaces/{workspace}/bundles/install

Request

Path parameters

workspacestring required

Slug of the workspace the request acts in

Request body

plan_digeststring required

The plan_digest analyze returned for this bundle and these setup values: the plan the caller approved.

setup_valuesobject

Values for the bundle's setup fields, keyed by setup field key.

Response

Successful Response

bundle_namestring required
installed_bundle_idstring nullable
setup_valuesobject

Non-secret setup values supplied to installs of this bundle, reused on redeploy.

Changes

  • 6cbb7d993f2eRevision changes
    • breaking

      added the new required request property

    • warning

      added the new orphaned enum value to the // response property for the response status

    • warning

      added the new unchanged enum value to the // response property for the response status

    • warning

      added the new updated enum value to the // response property for the response status

    • info

      added the new optional request property ///

    • info

      added the new optional request property ///

    • info

      added the new optional request property ///

    • info

      added the new optional request property ///

    • info

      added the new optional request property ///

    • info

      added the new optional request property ///

    • info

      the request property /// became optional

    • info

      added the new files enum value to the request property ///

    • info

      request property /// list-of-types was widened by adding types null to media type application/json

    • info

      added the optional property // to the response with the status

    • info

      added the optional property to the response with the status

  • a2981101dd93Revision changes
    • info

      added the new optional request property ///