# deployment
URL: https://synquic.tech/docs/cli/reference/deployment.md

Commands, arguments, and options for synq deployment.

See the [workflow guide](/docs/cli/deploy) for examples. Global flags such as `--json` go before the command; see [global options](/docs/cli/reference#global-options).

## synq deployment

Manage deployments (list, inspect, redeploy, rollback, …)

```text
synq deployment|deployments [options] [command]
```

| Subcommand | Purpose |
| --- | --- |
| [`list [options]`](/docs/cli/reference/deployment#synq-deployment-list) | List deployments (org-wide, or scoped to a project) |
| [`get <id>`](/docs/cli/reference/deployment#synq-deployment-get) | Show a single deployment |
| [`info <id>`](/docs/cli/reference/deployment#synq-deployment-info) | Show container info for a deployment |
| [`usage <id>`](/docs/cli/reference/deployment#synq-deployment-usage) | Show container resource usage for a deployment |
| [`redeploy [options] <id>`](/docs/cli/reference/deployment#synq-deployment-redeploy) | Redeploy from an existing deployment |
| [`rollback <id>`](/docs/cli/reference/deployment#synq-deployment-rollback) | Roll back to a previous deployment |
| [`pin [options] <id>`](/docs/cli/reference/deployment#synq-deployment-pin) | Pin (or unpin) a deployment's rollback artifact |
| [`cancel <id>`](/docs/cli/reference/deployment#synq-deployment-cancel) | Cancel an in-progress deployment |
| [`restart <id>`](/docs/cli/reference/deployment#synq-deployment-restart) | Restart a deployment's container |
| [`reject <id>`](/docs/cli/reference/deployment#synq-deployment-reject) | Reject a finished deployment awaiting a keep/reject decision |
| [`keep <id>`](/docs/cli/reference/deployment#synq-deployment-keep) | Keep a finished deployment awaiting a keep/reject decision |
| [`pending <id>`](/docs/cli/reference/deployment#synq-deployment-pending) | Show a deployment's current prompt and pending decisions |
| [`respond [options] <id>`](/docs/cli/reference/deployment#synq-deployment-respond) | Answer a pending deployment prompt |
| [`rm [options] <id>`](/docs/cli/reference/deployment#synq-deployment-rm) | Delete a deployment |
| [`ssl`](/docs/cli/reference/deployment#synq-deployment-ssl) | SSL certificate operations |

## synq deployment cancel

Cancel an in-progress deployment

```text
synq deployment cancel [options] <id>
```

| Argument | Meaning |
| --- | --- |
| `id` | Deployment ID |

## synq deployment get

Show a single deployment

```text
synq deployment get [options] <id>
```

| Argument | Meaning |
| --- | --- |
| `id` | Deployment ID |

## synq deployment info

Show container info for a deployment

```text
synq deployment info [options] <id>
```

| Argument | Meaning |
| --- | --- |
| `id` | Deployment ID |

## synq deployment keep

Keep a finished deployment awaiting a keep/reject decision

```text
synq deployment keep [options] <id>
```

| Argument | Meaning |
| --- | --- |
| `id` | Deployment ID |

## synq deployment list

List deployments (org-wide, or scoped to a project)

```text
synq deployment list [options]
```

| Option | Meaning |
| --- | --- |
| `--project <id>` | Scope to a project (defaults to the linked project) |
| `--env <environment>` | Filter by environment: production \| preview |
| `--limit <n>` | Max rows to fetch (default: "50") |

## synq deployment pending

Show a deployment's current prompt and pending decisions

```text
synq deployment pending [options] <id>
```

| Argument | Meaning |
| --- | --- |
| `id` | Deployment ID |

## synq deployment pin

Pin (or unpin) a deployment's rollback artifact

```text
synq deployment pin [options] <id>
```

| Argument | Meaning |
| --- | --- |
| `id` | Deployment ID |

| Option | Meaning |
| --- | --- |
| `--off` | Unpin instead of pin |

## synq deployment redeploy

Redeploy from an existing deployment

```text
synq deployment redeploy [options] <id>
```

| Argument | Meaning |
| --- | --- |
| `id` | Deployment ID |

| Option | Meaning |
| --- | --- |
| `--use-existing-commit` | Rebuild the same commit instead of the latest on the branch |

## synq deployment reject

Reject a finished deployment awaiting a keep/reject decision

```text
synq deployment reject [options] <id>
```

| Argument | Meaning |
| --- | --- |
| `id` | Deployment ID |

## synq deployment respond

Answer a pending deployment prompt

```text
synq deployment respond [options] <id>
```

| Argument | Meaning |
| --- | --- |
| `id` | Deployment ID |

| Option | Meaning |
| --- | --- |
| `--action <action>` | An action ID offered by the pending prompt |

## synq deployment restart

Restart a deployment's container

```text
synq deployment restart [options] <id>
```

| Argument | Meaning |
| --- | --- |
| `id` | Deployment ID |

## synq deployment rm

Delete a deployment

```text
synq deployment rm [options] <id>
```

| Argument | Meaning |
| --- | --- |
| `id` | Deployment ID |

| Option | Meaning |
| --- | --- |
| `-y, --yes` | Skip the confirmation prompt |

## synq deployment rollback

Roll back to a previous deployment

```text
synq deployment rollback [options] <id>
```

| Argument | Meaning |
| --- | --- |
| `id` | Deployment ID to roll back to |

## synq deployment ssl

SSL certificate operations

```text
synq deployment ssl [options] [command]
```

| Subcommand | Purpose |
| --- | --- |
| [`status <domain>`](/docs/cli/reference/deployment#synq-deployment-ssl-status) | Check SSL certificate status for a domain |
| [`renew [options] <domain>`](/docs/cli/reference/deployment#synq-deployment-ssl-renew) | Renew (issue) an SSL certificate for a domain |

## synq deployment ssl renew

Renew (issue) an SSL certificate for a domain

```text
synq deployment ssl renew [options] <domain>
```

| Argument | Meaning |
| --- | --- |
| `domain` | Domain to renew |

| Option | Meaning |
| --- | --- |
| `--www` | Also renew the www subdomain (separately — its own certificate) |

## synq deployment ssl status

Check SSL certificate status for a domain

```text
synq deployment ssl status [options] <domain>
```

| Argument | Meaning |
| --- | --- |
| `domain` | Domain to probe |

## synq deployment usage

Show container resource usage for a deployment

```text
synq deployment usage [options] <id>
```

| Argument | Meaning |
| --- | --- |
| `id` | Deployment ID |