List coding agent session events

List a coding-agent session’s events (model calls, compactions, rate limits, tool runs, prompts) in time order, keyset-paginated. Pass the previous response’s nextCursor to continue; filter with kinds (comma-separated).

GET /api/v1/coding-agent/sessions/{sessionId}/events

List coding agent session events

Python

import requests

url = "https://app.langwatch.ai/api/v1/coding-agent/sessions/{sessionId}/events"

headers = {"X-Auth-Token": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

200

{
  "events": [
    {
      "sessionId": "<string>",
      "timeUnixMs": 123,
      "recordId": "<string>",
      "eventKind": "<string>",
      "agent": "<string>",
      "sessionKeySource": "<string>",
      "traceId": "<string>",
      "spanId": "<string>",
      "promptId": "<string>",
      "querySource": "<string>",
      "agentType": "<string>",
      "eventSequence": 123,
      "requestId": "<string>",
      "model": "<string>",
      "inputTokens": 123,
      "outputTokens": 123,
      "cacheReadTokens": 123,
      "cacheCreationTokens": 123,
      "costUsd": 123,
      "durationMs": 123,
      "ttftMs": 123,
      "attempt": 123,
      "speed": "<string>",
      "stopReason": "<string>",
      "preTokens": 123,
      "postTokens": 123,
      "compactionTrigger": "<string>",
      "precomputeReuse": "<string>",
      "statusCode": "<string>",
      "errorType": "<string>",
      "rateLimitCarrier": "<string>",
      "retryDurationMs": 123,
      "toolName": "<string>",
      "success": "<string>",
      "decision": "<string>",
      "decisionSource": "<string>",
      "toolInputBytes": 123,
      "toolResultBytes": 123,
      "promptChars": 123,
      "totalTokens": 123,
      "repositoryHost": "<string>",
      "repositoryOwner": "<string>",
      "repositoryName": "<string>",
      "branch": "<string>"
    }
  ],
  "nextCursor": "<string>"
}

Authorizations

X-Auth-Token · string · header · required

Project API key for sending traces and accessing project-scoped resources. Format: sk-lw-... (no underscore). Obtain one by creating a project via the Admin API or the LangWatch UI.

Path Parameters

sessionId · string · required

The agent's own session id (session.id / conversation id).

Minimum string length: 1

Query Parameters

limit · integer · default: 500

Required range: x <= 1000

kinds · string

Comma-separated event kinds to include. Known kinds: model_call, compaction, rate_limit, api_error, retries_exhausted, tool_result, tool_decision, user_prompt, subagent_completed.

from · number

Epoch ms lower bound on event time; with to, prunes storage partitions for faster reads.

to · number

Epoch ms upper bound on event time.

cursor · string

Opaque keyset cursor from the previous response's nextCursor.

Response

200

application/json

Success

events · object[] · required

Show child attributes

nextCursor · string | null · required