Sessions
List and inspect agent sessions
List Sessions Endpoint
Query Parameters
workflow_id?|
Filter by workflow ID
execution_id?|
Filter by the execution these sessions belong to. Every session carries one; before this existed the parameter was accepted and silently dropped, returning the whole collection (#1263).
status?|
Filter by single status (legacy)
statuses?|
Comma-separated list of statuses (OR'd; takes precedence over status)
started_after?|
Inclusive ISO 8601 lower bound on started_at (timezone required)
started_before?|
Inclusive ISO 8601 upper bound on started_at (timezone required)
q?|
Case-insensitive substring match against session id and workflow id
page?integer
Page number
Default
1Range
1 <= valuepage_size?|
Items per page
limit?|Deprecated
Deprecated alias for page_size. Ignored when page_size is given.
Response Body
application/json
application/json
curl -X GET "https://loading/sessions"{
"sessions": [
{
"id": "string",
"workflow_id": "string",
"workflow_name": "string",
"execution_id": "string",
"phase_id": "string",
"parent_session_id": "string",
"root_session_id": "string",
"phase_display": "string",
"status": "string",
"agent_provider": "string",
"agent_model": "string",
"requested_model": "string",
"repos": [
"string"
],
"repos_display": "string",
"input_tokens": 0,
"output_tokens": 0,
"cache_creation_tokens": 0,
"cache_read_tokens": 0,
"total_tokens": 0,
"total_tokens_display": "0",
"total_cost_usd": "0",
"total_cost_display": "—",
"unpriced_observation_count": 0,
"duration_seconds": 0,
"duration_display": "—",
"started_at": "string",
"completed_at": "string",
"agent_model_display": "string"
}
],
"total": 0,
"page": 1,
"page_size": 50,
"excluded_undated": 0,
"status_counts": {
"property1": 0,
"property2": 0
}
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string",
"input": null,
"ctx": {}
}
]
}curl -X GET "https://loading/sessions/string"{
"id": "string",
"workflow_id": "string",
"workflow_name": "string",
"execution_id": "string",
"phase_id": "string",
"parent_session_id": "string",
"root_session_id": "string",
"phase_display": "string",
"milestone_id": "string",
"agent_provider": "string",
"agent_model": "string",
"requested_model": "string",
"repos": [
"string"
],
"repos_display": "string",
"status": "string",
"workspace_path": "string",
"input_tokens": 0,
"input_tokens_display": "0",
"output_tokens": 0,
"output_tokens_display": "0",
"cache_creation_tokens": 0,
"cache_creation_tokens_display": "0",
"cache_read_tokens": 0,
"cache_read_tokens_display": "0",
"total_tokens": 0,
"total_tokens_display": "0",
"total_cost_usd": "0",
"total_cost_display": "—",
"unpriced_observation_count": 0,
"cost_by_model": {
"property1": "string",
"property2": "string"
},
"cache_read_rate_display": "string",
"cache_write_rate_display": "string",
"operations": [
{
"operation_id": "string",
"operation_type": "string",
"timestamp": "2019-08-24T14:15:22Z",
"duration_seconds": 0,
"success": true,
"error_message": "string",
"input_tokens": 0,
"output_tokens": 0,
"total_tokens": 0,
"tool_name": "string",
"tool_use_id": "string",
"tool_input": {},
"tool_output": "string",
"message_role": "string",
"message_content": "string",
"thinking_content": "string",
"git": {
"operation": "string",
"sha": "string",
"branch": "string",
"repo": "string",
"message": "string",
"prev_branch": "string",
"is_clone": true,
"remote": "string",
"author": "string",
"files_changed": 0,
"insertions": 0,
"deletions": 0,
"commits_count": 0,
"commit_range": "string",
"remote_url": "string",
"details": "string",
"from_branch": "string",
"to_branch": "string",
"estimated_tokens_added": 0,
"estimated_tokens_removed": 0
},
"git_sha": "string",
"git_message": "string",
"git_branch": "string",
"git_repo": "string"
}
],
"started_at": "string",
"completed_at": "string",
"duration_seconds": 0,
"duration_display": "—",
"error_message": "string",
"metadata": {},
"agent_model_display": "string"
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string",
"input": null,
"ctx": {}
}
]
}Syntropic137 Docs v0.33.1 · Last updated March 2026