Skip to main content
PATCH
/
sessions
/
{session_id}
{
  "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>

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
object | null
​
metadata
object | null
​
summary
object | null

Response

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
object | null
required
​
session_state
object | null
required
​
agent_id
string | null
required
​
total_tokens
integer | null
required
​
agent_data
object | null
required
​
metrics
object | null
required
​
metadata
object | null
required
​
chat_history
Chat History · object[] | null
required
​
created_at
string<date-time> | null
required
​
updated_at
string<date-time> | null
required
⌘I