Deployment

A record of an infrastructure provisioning operation.

Each deployment tracks a single action (PROVISION, DECOMMISSION, or PLAN) against an instance. Deployments are immutable once created — you cannot modify a deployment, only create new ones.

Use the status field to monitor progress and elapsed_time to track duration. The deployed_by field identifies the user or service account that initiated the operation.

type Deployment {
  id: ID!
  status: DeploymentStatus!
  action: DeploymentAction!
  version: String!
  message: String
  createdAt: DateTime!
  updatedAt: DateTime!
  lastTransitionedAt: DateTime
  elapsedTime: Int!
  deployedBy: String
  instance: Instance
}

Fields

Deployment.id ● ID! non-null scalar {#id}

Deployment.status ● DeploymentStatus! non-null enum {#status}

Current lifecycle state of this deployment.

Deployment.action ● DeploymentAction! non-null enum {#action}

The infrastructure operation this deployment performs.

Deployment.version ● String! non-null scalar {#version}

The bundle version used for this deployment (e.g., 1.2.0).

Deployment.message ● String scalar {#message}

An optional message describing the purpose of this deployment, similar to a commit message.

Deployment.createdAt ● DateTime! non-null scalar {#created-at}

When this deployment was created (UTC).

Deployment.updatedAt ● DateTime! non-null scalar {#updated-at}

When this deployment record was last updated (UTC).

Deployment.lastTransitionedAt ● DateTime scalar {#last-transitioned-at}

When the deployment last changed status (UTC). Null if the deployment is still PENDING.

Deployment.elapsedTime ● Int! non-null scalar {#elapsed-time}

Wall-clock duration of the deployment in seconds.

For RUNNING deployments, this is a live timer counting from creation. For terminal states, this is the total time from creation to the final status transition. Returns 0 for PENDING deployments.

Deployment.deployedBy ● String scalar {#deployed-by}

The name of the user or service account that initiated this deployment. Null if the initiator has been removed.

Deployment.instance ● Instance object {#instance}

The instance that this deployment operates on.

Returned By

deployment query

Member Of

DeploymentPayload object ● DeploymentsPage object