Get Observability Sessions

Cursor-paginated sessions list.

Filter precedence:

agent_id (Streamkap or external:pk:cid synthetic form)
project_key_id + client_id (external pseudo-agent)
No entity filter - all-tenant-activity pseudo-row.

The FE never sends both flavours - but if it does, agent_id wins.

kind and entity_kind are reserved-slot dispatch params: today only kind=tool_call against entity_kind=streamkap|external returns data. Other valid combinations return an empty page until their backing tables / emitters land. Unknown values raise 400.

agent_idstring nullable

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

project_key_idstring nullable

External pseudo-agent: project_key_id

client_idstring nullable

External pseudo-agent: client_id

fromstring nullable

Time range start (ISO 8601)

tostring nullable

Time range end (ISO 8601)

toolstring nullable

Filter by tool name

statusstring nullable

success | error | denied

cursorstring nullable

Pagination cursor - last page's next_cursor

limitinteger

Max items

kindstring nullable

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

entity_kindstring nullable

Entity scope: streamkap | external | kb

Response

Successful Response

next_cursorstring date-time nullable

v3

Get Observability Sessions

Query parameters

Response