v97

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

Deployments

Create a deployment

Create a new deployment.

post/deployments

Response

Deployment created successfully

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