Get Observability Logs

Log lines for one agent or knowledge base.

Covers every deployed version of the entity, so log history survives redeploys.

Returns 404 when the id is not an agent or knowledge base in the caller’s tenant and service. Returns 503 with a structured kind when log storage is not available in this environment.

GET/agentic/observability/logs

Authorization

AuthorizationBearer token · headerrequired

Query parameters

agent_idstringrequired

Agent or knowledge base id

fromstring

Time range start (ISO 8601)

tostring

Time range end (ISO 8601)

levelstring

Floor level — DEBUG | INFO | WARN | ERROR (used when levels is absent)

default: "INFO"

levelsstring

Explicit comma-separated level set (e.g. 'WARN,ERROR'). Overrides the level floor when present.

searchstring

Substring filter on the log column

limitinteger

Max lines per call

min 1 · max 2000 · default: 200

sincestring

Live-tail cursor — only rows newer than this ISO 8601 ts

Responses

200

Successful Response

linesObservabilityLogLine[]required

Show properties

Array of ObservabilityLogLine

timestampstringrequired

levelstringrequired

messagestringrequired

scopestring

default: "agent"

job_id_prefixstringrequired

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/logs?agent_id=string' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json'

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

import requests

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

Response

{
  "lines": [
    {
      "timestamp": "string",
      "level": "string",
      "message": "string"
    }
  ],
  "scope": "agent",
  "job_id_prefix": "string"
}

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