Sign in

v1

latestOpenAPI 3.1.12026-08-063445179.6 KB
revisions

List revisions for app

List revisions for an app. Optionally filter by status.

get/v2/apps/{app}/revisions

Path parameters

appstring required

The app ID or slug. App slugs must be 3–32 characters long, may contain only lowercase letters, numbers, and hyphens, cannot contain underscores, must not start or end with a hyphen, must not have consecutive hyphens in positions 3 and 4, and cannot be a reserved slug. App IDs are UUIDs.

Query parameters

cursorstring

The pagination cursor

limitinteger

The maximum number of items to return

status'skipped' | 'queued' | 'building' | 'succeeded' | 'failed'

Filter revisions by status

Filter by revision status

Response

OK

idstring 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

labelsLabels
created_atstring required

ISO 8601 timestamp of creation

cancellation_requested_atstring nullable required

ISO 8601 timestamp when cancellation was requested, or null

build_finished_atstring nullable required

ISO 8601 timestamp when the build completed, or null if still building

deleted_atstring 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.

Example response

[
  {
    "labels": {
      "custom.customer_id": "cust_123",
      "custom.environment": "production",
      "custom.regions": [
        "us-east",
        "eu-west"
      ]
    }
  }
]