---
title: "Get Version Pod Logs"
method: GET
path: "/versions/{version_id}/pod-logs"
tags: ["Versions"]
---

# Get Version Pod Logs

`GET /versions/{version_id}/pod-logs`

Get Kubernetes pod/container logs for a specific deployment version.

    Data is sourced from ClickHouse `otel.pod_logs`, populated by the dedicated
    pod-log collector DaemonSet. This endpoint has no Kubernetes or event-snapshot
    fallback path.

## Path parameters

- `version_id` string, required

## Query parameters

- `pod` string, nullable — Filter by pod name
- `container` string, nullable — Filter by container name
- `stream` string, nullable — Filter by log stream (stdout/stderr)
- `since` string, date-time, nullable — Start timestamp filter (ISO 8601)
- `until` string, date-time, nullable — End timestamp filter (ISO 8601)
- `search` string, nullable — Full-text search in log message
- `limit` integer — Maximum number of results
- `after` string, nullable — Cursor for the next page, using the previous log_id

## Response `200`

Successful Response

- VersionPodLogsResponse — Paginated pod logs for a deployed version.
  - `has_more` boolean, required — Whether more matching logs exist beyond this page
  - `logs` VersionPodLogEntry[]
    - `agent_id` string, required — Agent ID associated with this log
    - `branch_id` string, nullable — Branch ID associated with this log
    - `cluster` string, nullable — Cluster name
    - `container_name` string, nullable — Container name
    - `k8s_namespace` string, nullable — Kubernetes namespace containing the pod
    - `log_id` string, required — Stable pod log identifier for pagination
    - `message` string, required — Pod log message
    - `pod_name` string, nullable — Kubernetes pod name
    - `stream` string, nullable — Container log stream (stdout/stderr)
    - `timestamp` string, required — ISO 8601 log timestamp
    - `version_id` string, required — Version ID associated with this log
  - `total` integer, required — Total number of matching logs

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/terminaluse/apis/sb0-api.md) · [All operations](https://skmtc.net/terminaluse/apis/sb0-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/terminaluse/sb0-api/revisions/f24a474dc415/schema)