> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aireserve.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Stream pod logs

> Returns live or recent container logs as a server-sent event (SSE) stream. Logs are relayed on demand from RunPod — AI Reserve stores no log archive. The connection closes when the log tail is exhausted or the client disconnects. Requires compute `manage` access.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/gpu/pods/{id}/logs
openapi: 3.0.3
info:
  title: AI Reserve Gateway API
  description: >-
    The AI Reserve API surface — OpenAI-compatible chat completions,
    Anthropic-compatible messages, Bedrock Converse, images, video, files,
    text-to-speech, realtime voice sessions, and GPU Compute pod/volume
    management — all behind one endpoint and one API key.
  version: 1.0.0
servers:
  - url: https://api.aireserve.com
security:
  - bearerAuth: []
paths:
  /v1/gpu/pods/{id}/logs:
    get:
      tags:
        - GPU Compute
      summary: Stream pod logs
      description: >-
        Returns live or recent container logs as a server-sent event (SSE)
        stream. Logs are relayed on demand from RunPod — AI Reserve stores no
        log archive. The connection closes when the log tail is exhausted or the
        client disconnects. Requires compute `manage` access.
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
        - name: tail
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 1000
            default: 100
          description: Number of recent lines to return before following live.
      responses:
        '200':
          description: Log stream (SSE) or snapshot.
        '403':
          description: Compute `manage` access required.
        '404':
          description: Pod not found or not in a state that produces logs.
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Your AI Reserve API key (aireserve_api_…) from the API Keys page in the
        portal (https://portal.aireserve.com/keys).

````