List Agent Logs

Query logs for an agent. Requires user authentication.

agent_namestring required

Name of the agent (format: namespace/name or agent ID)

branch_idstring nullable

Filter by branch/deployment ID

task_idstring nullable

Filter by task ID

trace_idstring nullable

Filter by OTEL trace ID (32 lowercase hex chars)

level'DEBUG' | 'INFO' | 'WARNING' | 'ERROR' | 'CRITICAL'

Log level for entries.

Filter by log level

source'stdout' | 'stderr' | 'server'

Source of the log entry.

Filter by source (stdout, stderr, server)

sincestring date-time nullable

Start timestamp filter (ISO 8601)

untilstring date-time nullable

End timestamp filter (ISO 8601)

searchstring nullable

Full-text search in message (case-insensitive)

after_idstring nullable

Return logs after this log_id (cursor-based pagination)

limitinteger

Maximum number of results

offsetinteger

Number of results to skip

Response

Successful Response

has_moreboolean required

totalinteger required