Deploy commands

The deploy commands mirror the platform’s deploys API — they trigger and inspect deployments. Managing the deploy target itself (the production app) lives under production-app commands.

create

Deploy a version to a production app:

synthetiq deploy create <production-app-id> [--version <version-id>] [--json]

Flag	Description
`--version <version-id>`	Version ID to deploy (default: the entity’s active version)

Deployment started: 3c1f8a44-9b2d-4e07-8f1a-6d5c2e9b7a01
Track it with: synthetiq deploy get 3c1f8a44-9b2d-4e07-8f1a-6d5c2e9b7a01

Fails with a conflict if a deployment for the production app is already in progress.

list

synthetiq deploy list [production-app-id] [--status <status>] [--limit <n>] [--page <n>] [--json]

ID              APP       VERSION          STATUS       DATE
3c1f8a44-…      my-app    0b54f3a8-…       completed    Jun 10, 2026
9b2d4e07-…      my-app    4c81d2e7-…       failed       Jun 5, 2026

Flag	Description
`--status <status>`	Filter: `in_progress`, `completed`, `failed`, `cancelled`
`--limit <n>`	Number of deployments to show (default: `10`)
`--page <n>`	Page number
`--json`	Output as JSON

get

Get a deployment’s status and phase breakdown:

synthetiq deploy get <deployment-id> [--json]

Deployment:  3c1f8a44-9b2d-4e07-8f1a-6d5c2e9b7a01
App:         my-app
Version:     0b54f3a8-91c2-4d7e-a6b1-8e2f5c9d3a10
Status:      in_progress
Created:     6/10/2026, 3:30:42 PM

Phases:
  orchestrate          completed
  download             completed
  infra                in_progress
  build                pending
  ...

cancel

synthetiq deploy cancel <deployment-id>

Only deployments currently in progress can be cancelled.

Production app commands

Infra commands

⌘I

Platform Docs

Synthetiq Desktop

Synthetiq CLI

App Framework

Services Framework

Workflows Framework

Platform API

Deployments

Deploy commands

create

list

get

cancel

​create

​list

​get

​cancel

create

list

get

cancel