Skip to content
Streamkap
Esc
↑↓navigate↵open⌘Jpreview

Get Observability Sessions

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
Authorization
AuthorizationBearer token · headerrequired
Query parameters
agent_idstring

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

project_key_idstring

External pseudo-agent: project_key_id

client_idstring

External pseudo-agent: client_id

fromstring

Time range start (ISO 8601)

tostring

Time range end (ISO 8601)

toolstring

Filter by tool name

statusstring

success | error | denied

cursorstring

Pagination cursor - last page's next_cursor

limitinteger

Max items

min 1 · max 200 · default: 50
kindstring

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

entity_kindstring

Entity scope: streamkap | external | kb

Responses
200

Successful Response

itemsObservabilitySessionItem[]required
Show properties
Array of ObservabilitySessionItem
session_idstringrequired
started_atstring<date-time>required
ended_atstring<date-time>required
call_countintegerrequired
error_countintegerrequired
p95_msnumber | null
Show properties
Any of:
number
number
null
null
agent_idstring | null
Show properties
Any of:
string
string
null
null
agent_labelstringrequired
entity_kindstringrequired
Allowed:streamkapexternal
next_cursorstring<date-time> | null
Show properties
Any of:
string<date-time>
string<date-time>
null
null
422

Validation Error

detailValidationError[]
Show properties
Array of ValidationError
locstring | integer[]required
Show properties
Array of string | integer
Any of:
string
string
integer
integer
msgstringrequired
typestringrequired
inputany
ctxobject
Request
curl -X GET 'https://api.streamkap.com/agentic/observability/sessions' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json'
Response
{
  "items": [
    {
      "session_id": "string",
      "started_at": "2019-08-24T14:15:22Z",
      "ended_at": "2019-08-24T14:15:22Z",
      "call_count": 0,
      "error_count": 0,
      "p95_ms": 0,
      "agent_id": "string",
      "agent_label": "string",
      "entity_kind": "streamkap"
    }
  ],
  "next_cursor": "2019-08-24T14:15:22Z"
}