---
title: "List revision history events of a deployment"
method: GET
path: "/v1/deployments/{id}/revisions"
tags: ["Deployments"]
---

# List revision history events of a deployment

`GET /v1/deployments/{id}/revisions`

## Request

- Base URL: `https://api.together.ai`
- URL: `https://api.together.ai/v1/deployments/{id}/revisions`
- Auth: HTTP bearer

Returns the revision history of the deployment, in descending order. Defaults to the most recent events.
Only the 200 most recent events are retained per deployment; paginating past that returns an empty list.

## Path parameters

- `id` string, required: Deployment ID or name.

## Query parameters

- `limit` integer: Maximum number of events to return (default 10, max 100).
- `before` integer: Return only events with event_number strictly less than this value for pagination.

## Response `200`

Revision history

- RevisionEventListResponse: Revision history events for a deployment, newest first.
  - `data` RevisionEventItem[], required: Revision events, newest first.
    - `object` 'revision_event', required: The object type, which is always `revision_event`.
    - `event_number` integer, required: Monotonic event number in the deployment's revision history.
    - `revision_id` string, required: Revision ID activated by this event.
    - `revision_number` integer, required: Human-readable per-deployment revision counter.
    - `image` string, required: Container image of the revision activated by this event.
    - `action` 'create' | 'update' | 'system' | 'rollback', required: How this revision became active.
    - `activated_at` string, date-time, required: Time when this revision became active.
  - `object` 'list', required: The object type, which is always `list`.

## Other responses

- `400`: Invalid pagination parameters
- `404`: Deployment not found
- `500`: Internal server error

## Changes

- **2026-10-22** `bb5257b3173a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/together/apis/together-apis/changes/v1/deployments/:id/revisions/get.md)

---

[API](https://skmtc.dev/together/apis/together-apis.md) - [All operations](https://skmtc.dev/together/apis/together-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/together/apis/together-apis/revisions/93438ddac711?raw)