v12

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01251238661.6 KB
v1
protected
agents

Install Agent

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.

post/v1/agents/{agent_id}/install

Path parameters

agent_idstring required

Response

Successful Response

a2ui_enabledboolean nullable
agent_typestring
descriptionstring nullable
events_configobject nullable
idstring uuid required
instructionstring nullable
is_catalogboolean
model_idstring nullable
namestring required
planningboolean nullable
registry_item_idstring nullable
skillsobject[] nullable
slugstring required
statusstring required
update_availableboolean