Sign in

v1

latestOpenAPI 3.1.12026-08-063445179.6 KB
revisions

Update revision

Update mutable revision properties. The only mutable property is retention, the revision's garbage-collection policy: auto follows the normal inactivity-based cleanup, while indefinite exempts the revision from automatic deletion so it keeps serving on its preview and pinned-production domains. Explicitly deleting the revision, or deleting its app, is always permitted regardless of retention.

indefinite is only available to enterprise organizations that have opted in — contact Deno support to enable it. For organizations without the feature, requests that set indefinite fail with 403 REVISION_RETENTION_NOT_AVAILABLE.

patch/v2/revisions/{revision}

Path parameters

revisionstring required

Revision ID (globally unique)

Request body

retention'auto' | 'indefinite'

The revision's garbage-collection policy (auto or indefinite)

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"
      ]
    }
  ]
}