STstreamkap
Agents Observability

Get Observability Sessions

Changed on

Cursor-paginated sessions list.

Filter precedence:

  1. agent_id (a Streamkap agent id, or the external:<pk>:<cid> form)
  2. project_key_id + client_id (external pseudo-agent)
  3. No entity filter - activity across the whole service.

If both agent_id and project_key_id + client_id are sent, agent_id wins.

kind and entity_kind select the row type and entity scope. Only kind=tool_call with entity_kind=streamkap|external returns data today; other valid combinations return an empty page. Unknown values return 400.

get/agentic/observability/sessions

Request

Query parameters

agent_idstring nullable

Streamkap agent id, or external:<pk>:<cid> for an external pseudo-agent

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

Changes