Events

Query session events, timelines, and tool usage

Get Recent Activity Endpoint

GET
/events/recent

Query Parameters

limit?integer

Max events to return

Default50
Range1 <= value <= 200

Response Body

application/json

application/json

curl -X GET "https://loading/events/recent"
{
  "events": [
    {
      "time": null,
      "event_type": "string",
      "session_id": "string",
      "execution_id": "string",
      "phase_id": "string",
      "data": {}
    }
  ],
  "count": 0,
  "has_more": false
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Get Session Events Endpoint

GET
/events/sessions/{session_id}

Path Parameters

session_id*string

Query Parameters

event_type?|

Filter by event type

limit?integer

Max events to return

Default100
Range1 <= value <= 1000
offset?integer

Offset for pagination

Default0
Range0 <= value

Response Body

application/json

application/json

curl -X GET "https://loading/events/sessions/string"
{
  "events": [
    {
      "time": null,
      "event_type": "string",
      "session_id": "string",
      "execution_id": "string",
      "phase_id": "string",
      "data": {}
    }
  ],
  "count": 0,
  "has_more": false
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Get Session Timeline Endpoint

GET
/events/sessions/{session_id}/timeline

Path Parameters

session_id*string

Query Parameters

limit?integer

Max entries

Default100
Range1 <= value <= 500

Response Body

application/json

application/json

curl -X GET "https://loading/events/sessions/string/timeline"
[
  {
    "time": null,
    "event_type": "string",
    "tool_name": "string",
    "duration_ms": 0,
    "success": true
  }
]
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Get Session Costs Endpoint

GET
/events/sessions/{session_id}/costs

Path Parameters

session_id*string

Response Body

application/json

application/json

curl -X GET "https://loading/events/sessions/string/costs"
{
  "session_id": "string",
  "input_tokens": 0,
  "output_tokens": 0,
  "total_tokens": 0,
  "cache_creation_tokens": 0,
  "cache_read_tokens": 0,
  "estimated_cost_usd": 0
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Get Session Tools Endpoint

GET
/events/sessions/{session_id}/tools

Path Parameters

session_id*string

Response Body

application/json

application/json

curl -X GET "https://loading/events/sessions/string/tools"
[
  {
    "tool_name": "string",
    "call_count": 0,
    "success_count": 0,
    "error_count": 0,
    "total_duration_ms": 0,
    "avg_duration_ms": 0
  }
]
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Syntropic137 Docs v0.18.0 · Last updated March 2026

On this page