apicheats.dev Cheat sheet Raw .md
POST

Try POST /v1/agents/{agent_id} — Claude API

Claude playground

Update Agent

Credentials

Kept in this tab only. Requests go through apicheats.dev's same-origin proxy straight to api.anthropic.com; the proxy stores and logs nothing about them.

Headers

Path

Body application/json

10 body fields
  • version · optional · integer — The agent's current version, used to prevent concurrent overwrites. Obtain this value from a create or retrieve response. Must be at least 1 if specified. When supplied, the request fails if it does not match the server's current version; omit to apply the update unconditionally.
  • name · optional · string — Human-readable name. Must be non-empty. Omit to preserve. Cannot be cleared.
  • description · optional · string — Description. Omit to preserve; send empty string or null to clear.
  • model · optional · string — Model identifier. Accepts the [model string](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison), e.g. `claude-opus-5`, or a `model_config` object for additional configuration control. Omit to preserve. Cannot be cleared.
  • system · optional · string — System prompt. Omit to preserve; send empty string or null to clear.
  • tools · optional · object[] — Tool configurations available to the agent. Full replacement. Omit to preserve; send empty array or null to clear. Maximum of 128 tools across all toolsets allowed.
  • mcp_servers · optional · object[] — MCP servers. Full replacement. Omit to preserve; send empty array or `null` to clear. Names must be unique. Maximum 20. Every server must be referenced by an `mcp_toolset` in the agent's resulting `tools`; unreferenced servers are rejected. See the [MCP connector guide](https://platform.claude.com/docs/en/managed-agents/mcp-connector).
  • skills · optional · object[] — Skills. Full replacement. Omit to preserve; send empty array or null to clear.
  • metadata · optional · object — Metadata patch. Set a key to a string to upsert it, or to null to delete it. Omit the field to preserve. The stored bag is limited to 16 keys (up to 64 chars each) with values up to 512 chars.
  • multiagent · optional · object — Multiagent orchestration configuration. Full replacement. Omit to preserve; send null to clear.