List deployments
List deployments. Optionally filter by application name and version.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Filter results by application name.
Filter results by application version. Requires app_name to be set.
Limit the number of deployments to return.
1 <= x <= 100Offset the number of deployments to return.
x >= 0Search deployments by ID or app name.
Response
List of deployments.
Timestamp when the deployment was created
Unique identifier for the deployment
"rr33xuugxj9h0bkf1rdt2bet"
Deployment region code
"aws.us-east-1a""aws.us-east-1a"
Current status of the deployment
queued, in_progress, running, failed, stopped "queued"
Relative path to the application entrypoint
"src/app.py"
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.
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.
"3f4d0ea1bd2c5c1a1a1f0e9d8c7b6a5948372615049382716a5b4c3d2e1f0a9b"
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.
"apps/api"
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.
"main"
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.
file, github "github"
For GitHub-sourced deployments, the repository URL that was fetched. Omitted for file uploads.
"https://github.com/org/repo"
Status reason
"Deployment in progress"
Timestamp when the deployment was last updated