Update agent
Update an existing agent. Only fields included in the request body are changed; omitted fields are left untouched.
This endpoint edits document fields only. To attach or detach skills, use PATCH /agents/{agent_id}/skills; to manage MCP servers, use the agent MCP server endpoints.
is_active: false is not a pause switch. It retires the agent: the agent disappears from GET /agents, and both GET and PATCH /agents/{agent_id} return 404 afterwards, so you cannot set it back to true through the API. To stop an agent from running on its own while keeping it fully reachable, disable its triggers instead.
Authorizations
Path Parameters
ID of the agent to update.
Body
ID of the LLM the agent runs on. Use GET /models to discover valid values.
"anthropic/claude-sonnet-4"
"Researches enterprise accounts and drafts outreach"
When provided, replaces the agent's tool list.
When provided, replaces the agent's resource list.
Setting this to false retires the agent: it disappears from GET /agents, and GET/PATCH /agents/{agent_id} return 404, so it cannot be reactivated through the API. This is not a pause switch — to stop an agent from running while keeping it reachable, disable its triggers instead.
When provided, transfers ownership of the agent to this team.
Response
The updated agent.
