> ## 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={"system"}
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={"system"}
synthetiq production-app get <production-app-id> [--json]
```

## create

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

Requires deployer access and provisioned infrastructure for the organization.

## update

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.