Update Session

POST/v1/sessions/{id}

Shallow-merge metadata or fully replace Session-local tool and MCP server overrides. Null metadata values delete keys; a null title preserves the current title.

Path parameters

stringidrequired

Session ID.

Request body

Optional<string | null>title

New title; null or omission preserves the current title.

Optional<object>metadata

Shallow merge patch; null property values delete keys.

Optional<array>agent.tools

Full replacement for the Session-local tool override.

Optional<array>agent.mcp_servers

Full replacement for the Session-local MCP server override.

curl -X POST https://api.sandbase.ai/v1/sessions/sess_01... \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"Research follow-up","metadata":{"phase":2,"obsolete_key":null}}'