Skip to main content
A production app ties an entity to a subdomain and its cloud infrastructure. It is the target you deploy versions to. These commands mirror the platform’s production-apps API. To run deployments against a production app, see deploy commands.

list

synthetiq production-app list [--entity-id <entity-id>] [--page <n>] [--page-size <n>] [--json]
ID              APP       SUBDOMAIN   URL                              CREATED
8f1a6d5c-…      my-app    my-app      https://my-app.apps.acme.com     Jun 10, 2026

get

synthetiq production-app get <production-app-id> [--json]

create

synthetiq production-app create <entity-id> --subdomain <subdomain> [--json]
Requires deployer access and provisioned infrastructure for the organization.

update

synthetiq production-app update <production-app-id> [--subdomain <subdomain>] [--worker-config <jsonPath>]
FlagDescription
--subdomain <subdomain>New subdomain
--worker-config <jsonPath>Path to a JSON file with the worker config

delete

synthetiq production-app delete <production-app-id> [--force]
Starts teardown of the production app and its infrastructure. Prompts for confirmation unless --force. Does not delete workspace source.

oauth-credentials

synthetiq production-app oauth-credentials <production-app-id> [--json]
Provisions (or rotates) the production app’s OAuth client credentials and prints the client ID and secret. The secret is shown once — store it immediately.