Sign in

v52

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-0189112274.5 KB
Agents

Register Build

Register an agent at build time, before it is deployed, so it can be permissioned and shared prior to deploy. Idempotent by name.

post/agents/register-build

Request body

namestring required

The unique name of the agent.

descriptionstring required

The description of the agent.

registration_metadataobject nullable

The metadata for the agent's build registration.

agent_input_type'text' | 'json'

Response

Successful Response

idstring required

The unique identifier of the agent.

namestring required

The unique name of the agent.

descriptionstring required

The description of the action.

status'Ready' | 'Failed' | 'Unknown' | 'Deleted' | 'Unhealthy' | 'BuildOnly'
acp_type'sync' | 'async' | 'agentic' required
status_reasonstring nullable

The reason for the status of the action.

created_atstring date-time required

The timestamp when the agent was created

updated_atstring date-time required

The timestamp when the agent was last updated

registration_metadataobject nullable

The metadata for the agent's registration.

registered_atstring date-time nullable

The timestamp when the agent was last registered

agent_input_type'text' | 'json'
production_deployment_idstring nullable

ID of the current production deployment.