Get Observability Iteration Detail

Ordered operations for one trace iteration (reads agent_traces).

Ordered by timestamp then a chat → tool_call → output tiebreak (sequence_number is not yet emitted). Tenant scoping makes a cross-tenant iteration_id return an empty list — same as “not found”, no existence leak.

GET/agentic/observability/iterations/{iteration_id}

Authorization

AuthorizationBearer token · headerrequired

Path parameters

iteration_idstringrequired

Responses

200

Successful Response

iteration_idstringrequired

operationsObservabilityOperation[]required

Show properties

Array of ObservabilityOperation

span_idstringrequired

operationstringrequired

statusstringrequired

duration_msintegerrequired

timestampstring<date-time>required

providerstring | null

Show properties

Any of:

string

string

null

null

modelstring | null

Show properties

Any of:

string

string

null

null

tool_namestring | null

Show properties

Any of:

string

string

null

null

input_tokensinteger | null

Show properties

Any of:

integer

integer

null

null

output_tokensinteger | null

Show properties

Any of:

integer

integer

null

null

truncatedboolean

default: false

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/string' \
  -H 'Authorization: Bearer YOUR_TOKEN'

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

import requests

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

Response

{
  "iteration_id": "string",
  "operations": [
    {
      "span_id": "string",
      "operation": "string",
      "status": "string",
      "duration_ms": 0,
      "timestamp": "2019-08-24T14:15:22Z",
      "provider": "string",
      "model": "string",
      "tool_name": "string",
      "input_tokens": 0,
      "output_tokens": 0
    }
  ],
  "truncated": false
}

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