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!
  params: Map
  message: String
  createdAt: DateTime!
  updatedAt: DateTime!
  lastTransitionedAt: DateTime
  elapsedTime: Int!
  deployedBy: String
  instance: Instance
  logs: [DeploymentLog!]!
}

Fields

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

Unique identifier for this deployment.

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.params ● Map scalar {#params}

Snapshot of the instance configuration at the time this deployment was enqueued. Independent of the instance's current params — later edits do not mutate this record.

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 deployments that have not yet executed (PENDING, PROPOSED, APPROVED).

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.

Deployment.logs ● [DeploymentLog!]! non-null object {#logs}

All log batches emitted for this deployment so far, ordered oldest-first.

Each entry is a single batch (logset) as emitted by the provisioner — its message may contain multiple \n-separated lines written in the same flush. For live streaming, open a deploymentEvents subscription after loading this field; the subscription fires on every subsequent append.

Returned By

deployment query

Member Of

DeploymentComparison object ● DeploymentEvent object ● DeploymentPayload object ● DeploymentsPage object