Get Observability Iterations Histogram

Operation-volume histogram over the trace stream. Default range 24h.

Status-stacked bucket shape matches the MCP histogram so the FE reuses one renderer; agent_traces has no denied status (always 0).

GET/agentic/observability/iterations/histogram

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)

bucketsinteger

min 1 · max 200 · default: 30

Responses

200

Successful Response

bucketsObservabilityHistogramBucket[]required

Show properties

Array of ObservabilityHistogramBucket

bucket_startstring<date-time>required

successintegerrequired

errorintegerrequired

deniedintegerrequired

totalintegerrequired

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

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

import requests

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

Response

{
  "buckets": [
    {
      "bucket_start": "2019-08-24T14:15:22Z",
      "success": 0,
      "error": 0,
      "denied": 0
    }
  ],
  "total": 0
}

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