Update session

PATCH /sessions/{session_id}

Update Session

cURL

curl --request PATCH \
  --url https://api.example.com/sessions/{session_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "session_name": "<string>",
  "session_state": {},
  "metadata": {},
  "summary": {}
}
'

200

update_summary

{
  "summary": {
    "summary": "The user discussed project planning with the agent.",
    "updated_at": "2025-10-21T14:30:00Z"
  }
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

session_id · string · required

Session ID to update

Query Parameters

type · enum<string> · default: agent

Session type (agent, team, or workflow)

Available options: agent, team, workflow

user_id · string | null

User ID

db_id · string | null

Database ID to use for update operation

Body

application/json

Session update data

session_name · string | null

session_state · Session State · object

metadata · Metadata · object

summary · Summary · object

Response

200

application/json

Session updated successfully

AgentSessionDetailSchema

TeamSessionDetailSchema

WorkflowSessionDetailSchema

user_id · string | null · required

agent_session_id · string · required

session_id · string · required

session_name · string · required

session_summary · Session Summary · object · required

session_state · Session State · object · required

agent_id · string | null · required

total_tokens · integer | null · required

agent_data · Agent Data · object · required

metrics · Metrics · object · required

metadata · Metadata · object · required

chat_history · Chat History · object[] | null · required

created_at · string<date-time> | null · required

updated_at · string<date-time> | null · required