---
title: "List Version Events"
method: GET
path: "/versions/{version_id}/events"
tags: ["Version Events"]
---

# List Version Events

`GET /versions/{version_id}/events`

List lifecycle events for a version. Events are ordered by sequence_id.

## Path parameters

- `version_id` string, required

## Query parameters

- `event_type` 'VERSION_CREATED' | 'VERSION_ACTIVATED' | 'VERSION_FAILED' | 'VERSION_DRAINING' | 'VERSION_RETIRED' | 'VERSION_ROLLED_BACK_FROM' | 'VERSION_ROLLED_BACK_TO' | 'VERSION_REDEPLOYED' | 'TASKS_MIGRATED' | 'VERSION_CLEANUP_FAILED' — Types of version lifecycle events.
- `after_sequence_id` integer, nullable — Return events after this sequence_id (for ascending pagination)
- `before_sequence_id` integer, nullable — Return events before this sequence_id (for descending pagination)
- `limit` integer — Maximum events to return
- `descending` boolean — Order by sequence_id descending (newest first)

## Response `200`

Successful Response

- VersionEventListResponse — Response model for listing version events.
  - `events` VersionEventResponse[], required — List of version events
    - `actor_id` string, nullable — User ID who triggered this event
    - `branch_id` string, required — Branch ID (denormalized)
    - `content` VersionEventContent — Typed content for version events stored as JSONB.
      - `actor_email` string, nullable — Email of the user who triggered this event
      - `container_logs` string, nullable — Best-effort container log snapshot for VERSION_FAILED events
      - `container_logs_container_name` string, nullable — Container name used when fetching container logs
      - `container_logs_fetched_at` string, date-time, nullable — When the container logs snapshot was fetched
      - `container_logs_pod_name` string, nullable — Pod name used when fetching container logs
      - `container_logs_source` string, nullable — Which log source was used (current or previous)
      - `container_logs_truncated` boolean, nullable — Whether container logs were truncated due to safety limits
      - `container_logs_unavailable_reason` string, nullable — Best-effort reason when container logs could not be fetched
      - `error_message` string, nullable — Error message for failure events
      - `failure_reason` string, nullable — Classified failure reason (DeploymentFailureReason value) for VERSION_FAILED events
      - `from_version_id` string, nullable — Version ID tasks were migrated FROM (for TASKS_MIGRATED events)
      - `git_hash` string, nullable — Git hash for context
      - `migrated_task_count` integer, nullable — Number of tasks migrated (for TASKS_MIGRATED events)
      - `migrated_task_ids` string[], nullable — Task IDs that were migrated (for TASKS_MIGRATED events)
      - `new_status` 'DEPLOYING' | 'ACTIVE' | 'FAILED' | 'UNHEALTHY' | 'DRAINING' | 'RETIRED' | 'ROLLED_BACK' — Status of a version in its lifecycle.
      - `previous_status` 'DEPLOYING' | 'ACTIVE' | 'FAILED' | 'UNHEALTHY' | 'DRAINING' | 'RETIRED' | 'ROLLED_BACK' — Status of a version in its lifecycle.
      - `target_version_id` string, nullable — Target version ID for rollback events
      - `triggered_by` 'deploy' | 'container_register' | 'rollback' | 'hot_swap' | 'helm_failure' | 'redeploy' | 'cleanup' | 'manual' — What triggered a version event.
    - `created_at` string, date-time, required — When this event was created
    - `event_type` 'VERSION_CREATED' | 'VERSION_ACTIVATED' | 'VERSION_FAILED' | 'VERSION_DRAINING' | 'VERSION_RETIRED' | 'VERSION_ROLLED_BACK_FROM' | 'VERSION_ROLLED_BACK_TO' | 'VERSION_REDEPLOYED' | 'TASKS_MIGRATED' | 'VERSION_CLEANUP_FAILED', required — Types of version lifecycle events.
    - `id` string, required — Event ID
    - `sequence_id` integer, required — Monotonically increasing sequence ID for ordering
    - `version_id` string, required — Version ID this event belongs to
  - `has_more` boolean, required — Whether there are more events after the last one
  - `total` integer, required — Total number of events returned

## 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)