AGagentarea
v1
protected
bundles

Analyze Bundle

Changed on

Parse and analyze a bundle source, returning a non-destructive preview.

For a bundle installed here before, each entity's status is a plan against that install: will_create, will_update, unchanged, orphaned (kept, not deleted), or changes_not_applied for a changed MCP server or GitHub skill.

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

Request

Path parameters

workspacestring required

Slug of the workspace the request acts in

Request body

filesobject nullable

An agent folder: relative POSIX path -> UTF-8 file text, rooted at agent.yaml. 5MB total.

setup_valuesobject

Setup values the install will be given, so a redeploy plan shows what a changed value updates. The plan_digest holds only for these values.

sourcestring nullable

Raw bundle source text (YAML or JSON).

source_urlstring nullable

URL to fetch raw bundle source from (YAML or JSON).

Response

Successful Response

installableboolean required

True when there are no blocking issues (setup may still be required).

plan_digeststring nullable

Names this plan: the bundle and what it does with each entity. Install takes it and refuses with 409 when the plan it would carry out is no longer this one. Null when there is no plan to install.

Changes

  • 6cbb7d993f2eRevision changes
    • breaking

      the response property /// became optional for the status

    • breaking

      response property bundle/mcps/items/json_spec list-of-types was widened by adding types null to media type application/json of response 200

    • warning

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

    • warning

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

    • 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 will_update 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 optional property /// to the response with the status

    • info

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

    • info

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

    • info

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

    • info

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

    • 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 optional property /// to the response with the status