Sessions

List and inspect agent sessions

List Sessions Endpoint

GET
/sessions

Query Parameters

workflow_id?|

Filter by workflow ID

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

started_before?|

Inclusive ISO 8601 upper bound on started_at

limit?integer

Max items to return

Default50
Range1 <= value <= 200

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",
      "phase_display": "string",
      "status": "string",
      "agent_provider": "string",
      "agent_model": "string",
      "agent_model_display": "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": "$0.00",
      "duration_seconds": 0,
      "duration_display": "—",
      "started_at": "string",
      "completed_at": "string"
    }
  ],
  "total": 0
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

Get Session Endpoint

GET
/sessions/{session_id}

Path Parameters

session_id*string

Response Body

application/json

application/json

curl -X GET "https://loading/sessions/string"
{
  "id": "string",
  "workflow_id": "string",
  "workflow_name": "string",
  "execution_id": "string",
  "phase_id": "string",
  "phase_display": "string",
  "milestone_id": "string",
  "agent_provider": "string",
  "agent_model": "string",
  "agent_model_display": "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": "$0.00",
  "cost_by_model": {
    "property1": "string",
    "property2": "string"
  },
  "operations": [
    {
      "operation_id": "string",
      "operation_type": "string",
      "timestamp": "2019-08-24T14:15:22Z",
      "duration_seconds": 0,
      "success": true,
      "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": {}
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

Syntropic137 Docs v0.25.4 · Last updated March 2026

On this page