Sign in
Deployments

Get a deployment

Returns a single deployment by ID from the caller's current workspace, with its derived status.

get/deployments/{id}

Request

  • Base URL: /v1 (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /v1/deployments/{id}
  • Auth: HTTP bearer

Path parameters

idstring required

The deployment ID (UUID).

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

created_atstring date-time required

When the deployment was created.

desired_statestring required

The desired state (run or stop).

github_branchstring required

The branch the deployment builds from.

github_commitstring required

The commit SHA the deployment builds from.

github_commit_authorstring required

The commit author's GitHub login.

github_commit_messagestring required

The first line of the commit message.

idstring required

The deployment ID.

statusstring required

Derived deployment status (INITIALIZING, BUILDING, DEPLOYING, HEALTHCHECK, RUNNING, STOPPED, FAILED, PENDING).

status_changed_atstring date-time required

When the deployment status last changed.

Example response

{
  "$schema": "/v1/schemas/DeploymentResponse.json"
}

Changes

No recorded changes to this operation across all 3 revisions of this API.