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.

GET /v2/serverless/{id}/workers/{workerId}/logs

Error

A valid request URL is required to generate request examples

200

{
  "source": "container",
  "line": "Model loaded.",
  "ts": "2026-05-01T22:00:00Z"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

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

200

text/event-stream

Worker log event stream

source · enum<string>

Available options: container, system

Example:

"container"

line · string

Example:

"Model loaded."

ts · string<date-time>

Example:

"2026-05-01T22:00:00Z"