Skip to main content

compareDeployments

Compare two deployments side-by-side.

Returns the bundle version on each side and a flat, leaf-level diff of the snapshotted params. Useful for auditing what a deploy changed, or for contrasting deploys from different points in time.

Both deployments must belong to the requesting organization. There is no requirement that they target the same instance — callers can pass any two deployments they have access to, though comparisons across unrelated instances will naturally show every leaf as "only on one side".

query {
  compareDeployments(organizationId: "my-org", sourceId: "<uuid-a>", targetId: "<uuid-b>") {
    source { id status version }
    target { id status version }
    version { source target equal }
    params { path source { value } target { value } equal }
  }
}
compareDeployments(
  organizationId: ID!
  sourceId: UUID!
  targetId: UUID!
): DeploymentComparison

Arguments​

compareDeployments.organizationId ● ID! non-null scalar {#organization-id}​

Your organization's unique identifier.

compareDeployments.sourceId ● UUID! non-null scalar {#source-id}​

The source deployment's unique identifier.

compareDeployments.targetId ● UUID! non-null scalar {#target-id}​

The target deployment's unique identifier.

Type​

DeploymentComparison object​

Side-by-side comparison of two deployments.

Returned by compareDeployments. Use this to audit what changed between two points in an instance's history ("what did this deploy change?") or to contrast two different deployments against each other.

The comparison is limited to snapshotted configuration — bundle version and params. Runtime state, logs, and produced artifacts are out of scope.