---
title: "List revisions for app"
method: GET
path: "/v2/apps/{app}/revisions"
tags: ["revisions"]
---

# List revisions for app

`GET /v2/apps/{app}/revisions`

List revisions for an app. Optionally filter by status.

## Path parameters

- `app` string, required

## Query parameters

- `cursor` string
- `limit` integer
- `status` 'skipped' | 'queued' | 'building' | 'succeeded' | 'failed' — Filter revisions by status

## Response `200`

OK

- RevisionListItem[]
  - `id` string, required — Unique revision identifier
  - `status` 'skipped' | 'queued' | 'building' | 'succeeded' | 'failed', required — Current revision lifecycle status
  - `failure_reason` 'error' | 'cancelled' | 'timed_out' | 'skipped', nullable, required — Reason for failure, or null if not failed
  - `labels` Labels
  - `created_at` string, required — ISO 8601 timestamp of creation
  - `cancellation_requested_at` string, nullable, required — ISO 8601 timestamp when cancellation was requested, or null
  - `build_finished_at` string, nullable, required — ISO 8601 timestamp when the build completed, or null if still building
  - `deleted_at` string, nullable, required — ISO 8601 timestamp of deletion, or null if active
  - `retention` 'auto' | 'indefinite' — Garbage-collection policy (`auto` or `indefinite`). Only present for enterprise organizations opted in to revision retention.

---

[API](https://skmtc.net/deno/apis/deploy.md) · [All operations](https://skmtc.net/deno/apis/deploy/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/deno/deploy/versions/5a56038d108e/schema)