Sign in

v1

latestOpenAPI 3.1.12026-08-063445179.6 KB
revisions

Get revision details

Get revision details.

Revision IDs are globally unique. The response includes layers, env_vars, and config when available.

Status lifecycle (one of):

  • queued -> building -> succeeded (success)
  • queued -> failed (build error, cancelled, or timeout)
  • queued -> skipped (e.g., commit message contains [skip-ci])

The timelines field is an eventually consistent view of routing: after a deploy or a domain change it may briefly reflect the previous state (typically for a few seconds at most).

get/v2/revisions/{revision}

Path parameters

revisionstring required

Revision ID (globally unique)

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 for this revision. auto follows the normal inactivity-based cleanup; indefinite exempts the revision from automatic deletion. Only available to enterprise organizations that have opted in to revision retention — contact Deno support to enable it. Absent for organizations without the feature, which cannot set it. Retention only guards against automatic deletion: explicitly deleting the revision, or deleting its app, always succeeds regardless.

Example response

{
  "id": "r2ysnrrhr352",
  "status": "succeeded",
  "failure_reason": null,
  "failure_detail": null,
  "labels": {
    "custom.branch": "main",
    "custom.sha": "abc123def456"
  },
  "layers": [
    {
      "id": "lyr_abc123",
      "slug": "deployment-secrets"
    }
  ],
  "env_vars": [
    {
      "key": "BUILD_ID",
      "value": "abc123"
    }
  ],
  "config": {
    "framework": "fresh",
    "install": "deno cache main.ts"
  },
  "created_at": "2024-01-15T10:30:00Z",
  "cancellation_requested_at": null,
  "build_finished_at": "2024-01-15T10:31:50Z",
  "deleted_at": null,
  "timelines": [
    {
      "name": "Production",
      "context": "Production",
      "hostnames": [
        "my-app.my-org.deno.net"
      ]
    }
  ]
}