Stream serverless worker logs
Streams a serverless worker’s logs as Server-Sent Events. The source
query parameter selects which log source to include.
The SSE data payload shape is:
{ "source": "container", "line": "...", "ts": "..." }.
Log-event id values are the event ts timestamp so browser/EventSource
reconnects can resume with Last-Event-ID.
Authorizations
Runpod API key authentication. Generate an API key in the Runpod console and send it in the Authorization header as Bearer <api_key>. Keys are scoped to the permissions granted when created; requests may return 403 when a valid key lacks access to the requested resource or action.
Headers
SSE reconnect cursor — a timestamp emitted by this endpoint. Takes
precedence over since and tail: when present, the stream resumes
from this point. Sent automatically by EventSource on reconnect.
Path Parameters
Serverless endpoint identifier
Worker identifier (from GET /v2/serverless/{id}/workers)
Query Parameters
Log source to stream. Omit to include both container and system logs. Log source to include in a log stream.
container— container stdout/stderr log streamsystem— host lifecycle/userlogs stream
container, system Number of historical lines to backfill before streaming. Defaults to
100 when omitted; set 0 to stream live with no backfill. Maximum 5000.
Ignored when since or Last-Event-ID is provided — the resume cursor
drives the backfill instead.
0 <= x <= 5000RFC3339 timestamp to resume from. Ignored when Last-Event-ID is
provided. When set, the stream resumes from this point and tail is
ignored.
Response
Worker log event stream
Server-Sent Events stream. Each event includes an id: line and a JSON data: payload with source, line, and ts fields.