apicheats.dev Cheat sheet Raw .md
POST

Try POST /v1/sessions/{session_id} — Claude API

Claude playground

Update Session

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

5 body fields
  • title · optional · string — Human-readable session title.
  • 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.
  • vault_ids · optional · string[] — Vault IDs (`vlt_*`) to attach to the session. Not yet supported; requests setting this field are rejected. Reserved for future use.
  • agent · optional · object — Agent configuration update. Only `tools` and `mcp_servers` are updatable mid-session. Only valid for sessions created from an agent or deployment reference. The session must not be running.
  • budget · optional · object — Enforced spend ceiling for the session. Set an object to replace the budget of a session that was created with one, or `null` to remove it; omit to preserve. A budget cannot be added to a session created without one (rejected with reason `budget_create_only`), and a removed budget cannot be re-added. Allowed in any non-terminated status. Lowering `max_list_cost` to at or below the session's consumed list cost is rejected with reason `budget_not_raised`, and every model the session can run must have a public list price or the request is rejected with reason `model_not_budgetable`.