Sign in

v97

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-31135175384.2 KB
Deployments

List deployments

List deployments. Optionally filter by application name and version.

get/deployments

Query parameters

app_namestring

Filter results by application name.

app_versionstring

Filter results by application version. Requires app_name to be set.

limitinteger

Limit the number of deployments to return.

offsetinteger

Offset the number of deployments to return.

querystring

Search deployments by ID or app name.

Response

List of deployments.

idstring required

Unique identifier for the deployment

status'queued' | 'in_progress' | 'running' | 'failed' | 'stopped' required

Current status of the deployment

status_reasonstring

Status reason

region'aws.us-east-1a' required

Deployment region code

entrypoint_rel_pathstring

Relative path to the application entrypoint

env_varsobject

Environment variables configured for this deployment. Values are redacted for API key, OAuth, and managed-auth callers, which receive every key with an empty string value. Only dashboard sessions receive the actual values.

created_atstring date-time required

Timestamp when the deployment was created

updated_atstring date-time nullable

Timestamp when the deployment was last updated

source_type'file' | 'github'

Origin of the deployed source code. This is read-only response provenance; file indicates an uploaded archive and github indicates a repository fetched by the API.

source_urlstring

For GitHub-sourced deployments, the repository URL that was fetched. Omitted for file uploads.

source_refstring

For GitHub-sourced deployments, the git ref as requested at deploy time (branch, tag, or commit SHA — not resolved to a commit). Omitted for file uploads.

source_pathstring

For GitHub-sourced deployments, the subpath within the repository that was used as the deploy root. Omitted when the repo root was used or for file uploads.

source_checksumstring

Hex-encoded SHA-256 checksum of the source archive. For file uploads, this hashes the uploaded archive; for GitHub-sourced deployments, this hashes the GitHub archive downloaded by the API. Omitted for deployments created before this field was recorded.

Example response

[
  {
    "id": "rr33xuugxj9h0bkf1rdt2bet",
    "status": "queued",
    "status_reason": "Deployment in progress",
    "region": "aws.us-east-1a",
    "entrypoint_rel_path": "src/app.py",
    "source_type": "github",
    "source_url": "https://github.com/org/repo",
    "source_ref": "main",
    "source_path": "apps/api",
    "source_checksum": "3f4d0ea1bd2c5c1a1a1f0e9d8c7b6a5948372615049382716a5b4c3d2e1f0a9b"
  }
]