Get Observability Iterations

Per-iteration trace rollup, newest-first.

One row per iteration_id — all operations of one input record’s processing chain. Traces cover Streamkap agents only, not external pseudo-agents. Results are scoped to the caller’s tenant: an agent_id from another tenant returns an empty page, so existence is never revealed.

GET/agentic/observability/iterations

Authorization

AuthorizationBearer token · headerrequired

Query parameters

agent_idstring

Streamkap agent id

fromstring

Time range start (ISO 8601)

tostring

Time range end (ISO 8601)

cursorstring

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 | null

Show properties

Any of:

string

string

null

null

agent_labelstring | null

Show properties

Any of:

string

string

null

null

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/iterations' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json'

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

import requests

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

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