v84

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

Agents

Update an agent

Update an agent's draft graph in place.

You must be a member of the agent's organization. The agent's draft is replaced with the supplied graph and re-validated, so you can iterate one draft — create, then update per fix — instead of creating a new agent on every change. The response carries the updated validation; publish with POST /v1/agents/{agent_id}/publish once validation.valid.

patch/v1/agents/{agent_id}

Path parameters

agent_idstring uuid required

The ID of the agent to update.

Request body

graphobject required

New workflow graph for the agent's draft version. Replaces the current draft graph; the agent is iterated in place rather than re-created, so its ID is stable. Required — a null graph is rejected as a 422 here rather than as a relayed upstream error.

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.