Skip to main content
GET
Stream serverless worker logs

Authorizations

Authorization
string
header
required

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

Last-Event-ID
string<date-time>

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

id
string
required

Serverless endpoint identifier

workerId
string
required

Worker identifier (from GET /v2/serverless/{id}/workers)

Query Parameters

source
enum<string>

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 stream
  • system — host lifecycle/userlogs stream
Available options:
container,
system
tail
integer
default:100

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.

Required range: 0 <= x <= 5000
since
string<date-time>

RFC3339 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.