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.
Unique identifier for the deployment
"rr33xuugxj9h0bkf1rdt2bet"
Current status of the deployment
queued, in_progress, running, failed, stopped "queued"
Deployment region code
"aws.us-east-1a""aws.us-east-1a"
Timestamp when the deployment was created
Status reason
"Deployment in progress"
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.
Timestamp when the deployment was last updated
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"
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"
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"
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"