deploy get

read onlyrepeatable

The state of one deployment: what it was built from, how it ended, and how long it took.

Polling this is how to wait for a build when the wait has to survive the process that started it. A pipeline that times out can pick the same deployment back up on its next run.

Usage

outplane deploy get <DEPLOYMENT> [APP]

Arguments

Argument	Type	Description
`DEPLOYMENT`	`string`	Deployment id, a number. Required.
`APP`	`string`	App name or id. Defaults to the linked app.

Output

Field	Type	Description
`deploymentId`	`int`
`app`	`string`
`appId`	`string`
`status`	`string`	One of `queued`, `building`, `deploying`, `ready`, `failed`, `crashed`, `canceled`.
`branch`	`string \| null`
`imageRef`	`string \| null`
`commitMessage`	`string \| null`
`startedAt`	`string`	RFC 3339, UTC.
`duration`	`string \| null`	The build only, humanised by the server.

Examples

Check a deployment by id

outplane deploy get 412 checkout

In a linked directory, the id is enough

outplane deploy get 412

Read one field in a script

outplane deploy get 4821 --json --fields status,finishedAt

{
  "finishedAt": "2026-08-02T09:14:05Z",
  "status": "ready"
}

What to Know

The application comes second, after the id. It is the one command in the CLI whose application is not the first argument, because the id is what a caller is holding when it needs this.
status is the deployment's own state and says nothing about whether the app is healthy now. A newer deployment may have replaced it.
Poll this rather than deploy create --wait when the wait has to survive the process being interrupted.

Errors

Beyond 0 for success, this command exits with:

Exit	Kind	Meaning
`2`	`usage`	Invalid arguments, unknown flag, or client-side validation failure.
`3`	`auth`	Not authenticated, token revoked or expired, or forbidden for this team.
`5`	`not_found`	The named resource does not exist, or is not visible to this credential.
`8`	`upstream`	The Out Plane API returned a server error.

The code on the error object is one of usage.bad_deployment_id, usage.missing_argument, app.not_found, context.no_app. Branch on that, or on the exit status. The message is prose and changes.