Logs
List Agent Logs
Query logs for an agent. Requires user authentication.
get/logs
Request
- Base URLhttps://docs.terminaluse.com (the document declares no server; this is the origin it was published from)
- Authnone declared
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Query parameters
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
Changes
No recorded changes to this operation across all 1 revision of this API.