Skip to main content
GET
Get Observability Sessions

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

agent_id
string | null

Streamkap agent id (Mongo ObjectId or external:pk:cid)

project_key_id
string | null

External pseudo-agent: project_key_id

client_id
string | null

External pseudo-agent: client_id

from
string | null

Time range start (ISO 8601)

to
string | null

Time range end (ISO 8601)

tool
string | null

Filter by tool name

status
string | null

success | error | denied

cursor
string | null

Pagination cursor - last page's next_cursor

limit
integer
default:50

Max items

Required range: 1 <= x <= 200
kind
string | null

Row kind: tool_call (default) | log | llm_call | transcript_event | kb_ingestion

entity_kind
string | null

Entity scope: streamkap | external | kb

Response

Successful Response

/agentic/observability/sessions response envelope.

next_cursor is the started_at of the last row in the page, or None when fewer than limit rows were returned (signalling end of stream to the FE).

items
ObservabilitySessionItem · object[]
required
next_cursor
string<date-time> | null