{ "opencollection": "1.0.0", "info": { "name": "Deno Deploy REST Apps Revisions API", "version": "1.0" }, "request": { "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "items": [ { "info": { "name": "Revisions", "type": "folder" }, "items": [ { "info": { "name": "Create revision", "type": "http" }, "http": { "method": "POST", "url": "https://api.deno.com/v1/apps/:app/deploy", "params": [ { "name": "app", "value": "", "type": "path", "description": "App UUID or human-readable slug" } ], "body": { "type": "json", "data": "{}" } }, "docs": "Creates a new revision (deployment) for an application by uploading assets and optional configuration. Assets are key-value pairs where keys are file paths relative to /app/src and values describe file content as UTF-8 text, base64-encoded binary, or symlinks. The revision progresses through queued, building, and succeeded (or failed) states. Build progress can be tracked via the revisions progress endpoint." }, { "info": { "name": "List revisions for app", "type": "http" }, "http": { "method": "GET", "url": "https://api.deno.com/v1/apps/:app/revisions", "params": [ { "name": "app", "value": "", "type": "path", "description": "App UUID or human-readable slug" }, { "name": "cursor", "value": "", "type": "query", "description": "Opaque pagination cursor from the previous response Link header" }, { "name": "limit", "value": "", "type": "query", "description": "Maximum number of revisions to return (1-100)" }, { "name": "status", "value": "", "type": "query", "description": "Filter revisions by build status" } ] }, "docs": "Returns a cursor-paginated list of all revisions for a specific application, optionally filtered by build status. Results are ordered by creation date descending." }, { "info": { "name": "Get revision details", "type": "http" }, "http": { "method": "GET", "url": "https://api.deno.com/v1/revisions/:revision", "params": [ { "name": "revision", "value": "", "type": "path", "description": "Globally unique revision ID" } ] }, "docs": "Retrieves complete details for a specific revision by its globally unique revision ID, including build status, failure reason, labels, layers, environment variables, and runtime configuration." }, { "info": { "name": "Delete revision", "type": "http" }, "http": { "method": "DELETE", "url": "https://api.deno.com/v1/revisions/:revision", "params": [ { "name": "revision", "value": "", "type": "path", "description": "Globally unique revision ID" } ] }, "docs": "Permanently deletes a specific revision. Revisions that are currently serving production or preview traffic cannot be deleted until the associated app is updated to use a different revision." }, { "info": { "name": "Cancel revision build", "type": "http" }, "http": { "method": "POST", "url": "https://api.deno.com/v1/revisions/:revision/cancel", "params": [ { "name": "revision", "value": "", "type": "path", "description": "Globally unique revision ID" } ] }, "docs": "Requests cancellation of an in-progress revision build. Only revisions in the queued or building state can be cancelled. The revision status transitions to failed upon successful cancellation." }, { "info": { "name": "Stream revision build progress", "type": "http" }, "http": { "method": "GET", "url": "https://api.deno.com/v1/revisions/:revision/progress", "params": [ { "name": "revision", "value": "", "type": "path", "description": "Globally unique revision ID" } ] }, "docs": "Streams real-time build progress for a revision as it moves through the preparing, installing, building, and deploying stages. Returns a Server-Sent Events stream or newline-delimited JSON stream depending on the Accept header. The stream emits message events containing RevisionProgress objects, a done event on completion, and an error event on failure." } ] } ], "bundled": true }