Skip to main content
GET
Get Observability Logs

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

agent_id
string
required

Agent or knowledge base id (Mongo ObjectId)

from
string | null

Time range start (ISO 8601)

to
string | null

Time range end (ISO 8601)

level
string
default:INFO

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

levels
string | null

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

search
string | null

Substring filter on the log column

limit
integer
default:200

Max lines per call

Required range: 1 <= x <= 2000
since
string | null

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

Response

Successful Response

/agentic/observability/logs response envelope.

scope always "agent" on this endpoint — per-job filtering is real (the job_id prefix LIKE catches only this entity's history). The kubectl-tail path's "namespace" value disappears here. job_id_prefix is echoed back so the FE can render "N versions" hints when a redeployed agent's history is mixed in.

lines
ObservabilityLogLine · object[]
required
job_id_prefix
string
required
scope
string
default:agent
Allowed value: "agent"