v84

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-0985248447.1 KB

Agents

Publish an agent

Publish an agent's latest draft as its live published version.

You must be a member of the agent's organization. Publishing promotes the current draft graph to a new published version. A draft that cannot produce its declared input/output contract is rejected with 422 and is not published.

post/v1/agents/{agent_id}/publish

Path parameters

agent_idstring uuid required

The ID of the agent to publish.

Response

Successful Response

idstring uuid required

Unique ID for the agent.

organization_idstring uuid required

Unique ID of the organization that owns the agent.

namestring required

Display name of the agent.

status'draft' | 'published' | 'unknown' required

Current availability status for an agent.

created_atstring date-time required

When the agent was created.

descriptionstring nullable

Short description of the agent, if provided.