Get Observability Sessions

Cursor-paginated sessions list.

Filter precedence:

1. agent_id (Streamkap or external:pk synthetic form)
2. project_key_id + client_id (external pseudo-agent)
3. 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.

curl -X GET "https://api.streamkap.com/agentic/observability/sessions" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch("https://api.streamkap.com/agentic/observability/sessions", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

import requests

response = requests.get(
    "https://api.streamkap.com/agentic/observability/sessions",
    headers={
        "Authorization": "Bearer YOUR_TOKEN"
    },
)

{
  "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"
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}