> ## Documentation Index
> Fetch the complete documentation index at: https://runpod-b18f5ded-lg-apiv2-new.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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`.




## OpenAPI

````yaml get /v2/serverless/{id}/workers/{workerId}/logs
openapi: 3.0.3
info:
  title: RunPod REST API
  version: 2.0.0
  description: RunPod public REST API — v2
servers:
  - url: /
    description: Current server
security:
  - bearerAuth: []
paths:
  /v2/serverless/{id}/workers/{workerId}/logs:
    parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
        description: Serverless endpoint identifier
        example: ep_abc123
      - name: workerId
        in: path
        required: true
        schema:
          type: string
        description: Worker identifier (from GET /v2/serverless/{id}/workers)
        example: worker_abc
    get:
      tags:
        - Serverless
      summary: Stream serverless worker logs
      description: >
        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`.
      operationId: getWorkerLogs
      parameters:
        - $ref: '#/components/parameters/LogSourceParam'
        - $ref: '#/components/parameters/LogTail'
        - $ref: '#/components/parameters/LogSince'
        - $ref: '#/components/parameters/LogLastEventID'
      responses:
        '200':
          description: Worker log event stream
          headers:
            Cache-Control:
              schema:
                type: string
              description: Always `no-cache` for SSE responses.
            Connection:
              schema:
                type: string
              description: Always `keep-alive` to hold the SSE stream open.
            X-Accel-Buffering:
              schema:
                type: string
              description: Always `no` to disable proxy buffering of the SSE stream.
          content:
            text/event-stream:
              schema:
                type: object
                properties:
                  source:
                    type: string
                    enum:
                      - container
                      - system
                    example: container
                  line:
                    type: string
                    example: Model loaded.
                  ts:
                    type: string
                    format: date-time
                    example: '2026-05-01T22:00:00Z'
        '404':
          description: Worker not found
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        default:
          description: Error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  parameters:
    LogSourceParam:
      name: source
      in: query
      required: false
      description: Log source to stream. Omit to include both container and system logs.
      schema:
        $ref: '#/components/schemas/LogSource'
    LogTail:
      name: tail
      in: query
      required: false
      description: |
        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.
      schema:
        type: integer
        minimum: 0
        maximum: 5000
        default: 100
    LogSince:
      name: since
      in: query
      required: false
      description: |
        RFC3339 timestamp to resume from. Ignored when `Last-Event-ID` is
        provided. When set, the stream resumes from this point and `tail` is
        ignored.
      schema:
        type: string
        format: date-time
    LogLastEventID:
      name: Last-Event-ID
      in: header
      required: false
      description: |
        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.
      schema:
        type: string
        format: date-time
  schemas:
    ErrorResponse:
      type: object
      properties:
        title:
          type: string
          description: Short human-readable summary
          example: Not Found
        status:
          type: integer
          description: HTTP status code
          example: 404
        detail:
          type: string
          description: Human-readable explanation
          example: pod not found
    LogSource:
      type: string
      description: |
        Log source to include in a log stream.
        - `container` — container stdout/stderr log stream
        - `system`    — host lifecycle/userlogs stream
      x-enum-varnames:
        - LogSourceContainer
        - LogSourceSystem
      enum:
        - container
        - system
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: RunPod API Key

````