> ## Documentation Index
> Fetch the complete documentation index at: https://synthetiq.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Production app commands

> Manage production apps — the deploy targets for your entities

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](/docs/platform-docs/cli/deploy).

## list

```bash theme={null}
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

```bash theme={null}
synthetiq production-app get <production-app-id> [--json]
```

## create

```bash theme={null}
synthetiq production-app create <entity-id> --subdomain <subdomain> [--json]
```

Requires deployer access and provisioned infrastructure for the organization.

## update

```bash theme={null}
synthetiq production-app update <production-app-id> [--subdomain <subdomain>] [--worker-config <jsonPath>] [--app-url <url>] [--api-url <url>]
```

| Flag                         | Description                                                        |
| ---------------------------- | ------------------------------------------------------------------ |
| `--subdomain <subdomain>`    | New subdomain                                                      |
| `--worker-config <jsonPath>` | Path to a JSON file with the worker config                         |
| `--app-url <url>`            | Vanity frontend origin (custom domain); pass `""` to clear         |
| `--api-url <url>`            | Vanity API base / OAuth issuer (custom domain); pass `""` to clear |

Vanity URLs require a proxy on your domain and take effect on the next deploy; see [Vanity URLs](/docs/platform-docs/deployments/vanity-urls).

## delete

```bash theme={null}
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

```bash theme={null}
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.