Update Agent

Request parameters

• agent_idstring必填

  path: Filter results by agent ID.

• namestring可选

  Agent name; omit to preserve. Cannot be cleared.

• modelstring | object可选

  The model powering the agent: a model name string (e.g. claude-opus-5) or an object for extra configuration (see subfields).

  ▸ 展开子字段（4）

  • idstring必填

    The model name string, e.g. claude-opus-5.

  • effortstring | object可选

    How hard the model works per inference: a bare level string (e.g. high) or a {type: high} object. On create, omitted resolves the per-model default; on update, omitting preserves it.

  • inference_geostring可选

    Geographic region for inference; unset falls through to the workspace default. model is replaced wholesale — omitting the subfield on update clears it.

  • speedstring可选

    Inference speed mode: fast generates output notably quicker at premium pricing. Not all models support it; invalid combinations are rejected at create time.

• systemstring可选

  System prompt; omit to preserve, send an empty string or null to clear.

• descriptionstring可选

  Description; omit to preserve, send an empty string or null to clear.

• mcp_serversarray可选○ 未支持

  Full-replacement MCP server list; omit to preserve, send an empty array or null to clear.

• metadataobject可选

  Metadata patch: set a key to a string to upsert it, or to null to delete it; omit the field to preserve. Up to 16 keys of at most 512 characters.

• multiagentobject可选

  Multiagent topology: the session's primary thread orchestrates work by spawning session threads drawn from the agents roster.

  ▸ 展开子字段（2）

  • agentsarray必填

    A roster of 1-20 agent IDs, {type: agent, id, version?} references or at most one {type: self}. Versions are pinned on create/update. Members must be distinct, exist, be unarchived and have no multiagent topology. Each coordinator permits at most one advisor whose model must be available and differ from the agent model; only the primary session can consult it, each consultation uses a separate advisor thread, and advice returns via agent.thread_message_received.

  • typestring必填

    Topology type; only coordinator today.

    取值 coordinator
• skillsarray可选○ 未支持

  Full-replacement skill list; omit to preserve, send an empty array or null to clear.

• toolsarray可选

  Full-replacement tool configuration; omit to preserve, send an empty array or null to clear.

• ▸ 更多参数（1）

  • versionnumber可选

    The agent's current version for concurrency control: must match the version returned by the latest create or retrieve, or the call answers a conflict.

Returns

200

Use version for optimistic concurrency; conflicts return 409 and unchanged updates preserve the version. MCP and skills are not supported. multiagent accepts null or a coordinator roster of 1–20 agent IDs, {type:"agent",id,version?} references or at most one {type:"self"}. Versions are pinned on create/update. Members must be distinct, exist, be unarchived and have no multiagent topology. The compatibility API provides only the eight official tools: bash, edit, glob, grep, read, write, web_search and web_fetch. configs rejects other tool names. Sessions created here do not provide background tasks, Monitor or subagents. Use /agent/v1 for all native tools. Each coordinator permits at most one advisor whose model must be available and differ from the agent model; only the primary session can consult it, each consultation uses a separate advisor thread, and advice returns via agent.thread_message_received.

Errors follow the Claude Managed Agents format — see error codes