Skip to main content
GET
`GET /api/observe/agents/{agent_ref}/logs`

Path Parameters

agent_ref
string
required

Agent UUID or name

Query Parameters

since
string | null

ISO-8601 start time (default: 24 h ago)

until
string | null

ISO-8601 end time (default: now)

limit
integer
Required range: x >= 0
level
string | null

Filter by level: INFO | WARN | ERROR | DEBUG

search
string | null

Substring search inside message

Response

Merged, time-sorted log lines

message
string
required
source
string
required

"proxy" | "container" | "loki"

timestamp
string<date-time>
required
level
string | null

"INFO" | "WARN" | "ERROR" | "DEBUG" — may be None for raw container output

trace_id
string | null

Present when the log was emitted in the context of an A2A flow