Stream task execution logs in real-time using Server-Sent Events (SSE). Perfect for live monitoring and building real-time dashboards.
bb_xxxxxxxxxxxxxxxxxxxxxx
Bearer <api_key>.Example: Bearer bb_b41b647ffbfed27f61656049d3eaeef3d903cc503345d9eb80080d98bc09qQe2F8Z_nXx9-eJA0BD6fromIndex=50 (resume from log index 50)includeStatus=false (only stream logs, no status updates)taskId - Task identifierfromIndex - Starting log indexmessage - Connection confirmation messagetimestamp - ISO 8601 timestampindex - Log position in arraylog - Log entry object containing:
type - Log type (info, error, success, warning, system)contentType - Content format (agentResponse, ansi, system, message, plain-text)message - Log message contenttimestamp - When log was createdagent - Agent that generated the log (claude, blackbox, codex, gemini)step - Execution step identifiertimestamp - ISO 8601 timestamp when log was sentincludeStatus=true).Data Fields:status - Current task status (pending, processing, saving, completed, error, stopped, timeout)error - Error message if task failed (null otherwise)status - Final task statustotalLogs - Total number of logs sentmessage - Completion messagetimestamp - ISO 8601 timestamperror - Error messagedetails - Additional error details (optional)Content-Type: text/event-stream. Each event follows this format:
| Status Code | Error | Description |
|---|---|---|
| 200 | Success | Stream established successfully |
| 401 | Unauthorized | Invalid or missing API key |
| 404 | Not Found | Task not found or user does not have access |
| 500 | Internal Server Error | Failed to start log stream |