v1

latestOpenAPI 3.1.02026-08-04151221521.2 KB
Logs

Stream Agent Logs

Stream logs for an agent in real-time using Server-Sent Events (SSE). Emits multiple event types (connected, log, error) discriminated by 'type' field. Only streams NEW logs after connection (like tail -f). Auto-disconnects after 5 minutes for cost control.

get/logs/stream

Query parameters

agent_namestring required

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

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

task_idstring nullable

Filter by task ID

Filter by task ID

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

Log level for entries.

Minimum log level

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

Source of the log entry.

Filter by source (stdout, stderr, server)

branch_idstring nullable

Filter by branch/version ID

Filter by branch/version ID

Response

SSE stream of log events

OR
OR