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 a custom agent.

Body

application/json

Native abilities. On PATCH /agents/{agent_id}/abilities send only the ones you want to change; each is a small object so settings travel with the toggle.

web_fetch
object
image_generation
object
search_past_conversations
object
ask_question
object

Whether the agent may pause to ask the person a question.

tool_discovery
object
manage_evaluations
object
browser
object
version
integer

Optional. The version you last read; the update is refused with 409 agent_version_conflict if the agent changed since.

Response

The agent's abilities after the change.

agent_id
string
Example:

"abc123DEFghiJKL"

abilities
object

Native abilities. On PATCH /agents/{agent_id}/abilities send only the ones you want to change; each is a small object so settings travel with the toggle.

version
integer | null
Example:

5