Deployments

Deploy from an uploaded static bundle

Changed on

Triggers a deployment using a previously uploaded static file bundle.

post/projects/{project_id}/environments/{environment_id}/deploy/static

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/projects/{project_id}/environments/{environment_id}/deploy/static
  • Auth: HTTP bearer

Path parameters

project_idinteger required
environment_idinteger required

Request body

health_check_pathstring nullable

Optional HTTP health-check path override (e.g. "/api/healthz"). Static deploys can't read .temps.yaml, so this sets the path the deployer probes after the container starts and the path the environment's uptime monitor checks. Must start with '/'. When omitted, defaults to "/".

metadataunknown
static_bundle_idinteger required

Static bundle ID (required)

Example request

{
  "health_check_path": "/api/healthz"
}

Response

Deployment started

created_atstring date-time required
environment_idinteger required
idinteger required
project_idinteger required
slugstring required
source_typestring required
statestring required

Example response

{
  "created_at": "2025-10-12T12:15:47.609192Z"
}

Changes