Skip to main content
PATCH
cURL

Authorizations

Authorization
string
header
required

A personal API key or an OAuth 2.0 access token. Personal API keys also require the x-auth-key header with your user ID.

Path Parameters

agent_id
string
required

ID of the agent to update.

Body

application/json
name
string | null
model_name
string | null

ID of the LLM the agent runs on. Use GET /models to discover valid values.

Example:

"anthropic/claude-sonnet-4"

description
string | null
Example:

"Researches enterprise accounts and drafts outreach"

system_prompt
string | null
tools
object[] | null

When provided, replaces the agent's tool list.

resources
object[] | null

When provided, replaces the agent's resource list.

metadata
object | null
is_active
boolean | null
team_id
string | null

When provided, transfers ownership of the agent to this team.

Response

The updated agent.

agent
object