Get Observability Iterations

Per-iteration trace rollup, newest-first (reads agent_traces).

One row per iteration_id — all operations of one input-record’s processing chain. agent_traces is Streamkap-agent only (no external pseudo-agents), so agent_id passes straight through with no entity resolution. Tenant scoping at the WHERE layer; a cross-tenant agent_id returns an empty page, not a leak.

GET/agentic/observability/iterations

Authorization

AuthorizationBearer token · headerrequired

Query parameters

agent_idstring | any

Streamkap agent id (Mongo ObjectId)

fromstring | any

Time range start (ISO 8601)

tostring | any

Time range end (ISO 8601)

cursorstring | any

Pagination cursor — last page's next_cursor

limitinteger

min 1 · max 200 · default: 50

Responses

200

Successful Response

itemsObservabilityIterationItem[]required

Show properties

Array of ObservabilityIterationItem

iteration_idstringrequired

started_atstring<date-time>required

ended_atstring<date-time>required

op_countintegerrequired

error_countintegerrequired

duration_ms_totalintegerrequired

agent_idstring | any

Show properties

Any of:

string

string

any

any

agent_labelstring | any

Show properties

Any of:

string

string

any

any

next_cursorstring<date-time> | any

Show properties

Any of:

string<date-time>

string<date-time>

any

any

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/iterations" \
  -H "Authorization: Bearer YOUR_TOKEN"

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

import requests

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

Response

{
  "items": [
    {
      "iteration_id": "string",
      "started_at": "2019-08-24T14:15:22Z",
      "ended_at": "2019-08-24T14:15:22Z",
      "op_count": 0,
      "error_count": 0,
      "duration_ms_total": 0,
      "agent_id": "string",
      "agent_label": "string"
    }
  ],
  "next_cursor": "2019-08-24T14:15:22Z"
}

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