AGagentarea
v1
protected
agents

Install Agent

Changed on

Add a built-in catalog agent to the workspace (copy-on-write fork).

Resolves a catalog agent by UUID or slug and materializes a tenant copy. Idempotent: returns the existing workspace copy if already installed. A policy rule refusing the item's registry answers 403.

post/v1/workspaces/{workspace}/agents/{agent_id}/install

Request

Path parameters

agent_idstring required
workspacestring required

Slug of the workspace the request acts in

Response

Successful Response

a2a_urlstring nullable
a2ui_enabledboolean nullable
agent_typestring
client_idstring uuid nullable
descriptionstring nullable
idstring uuid required
instructionstring nullable
is_catalogboolean
model_idstring nullable
namestring required
planningboolean nullable
reasoning_effortstring nullable
reasoning_max_tokensinteger nullable
registry_item_idstring nullable
skillsobject[] nullable
slugstring required
statusstring required
update_availableboolean

Changes

  • fc6f062f7d70Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • 97bdabfb1aaaRevision changes
    • info

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