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

# ravion deploy

> Trigger, list, inspect, promote, and roll back Ravion module deployments from the command line using the `ravion deploy` command group.

## `ravion deploy`

Manage deployments

**Aliases:** `deploys`, `deployment`, `deployments`

### `ravion deploy cancel`

Cancel a deployment

```bash theme={null}
ravion deploy cancel <id> [flags]
```

**Flags:**

| Flag     | Required | Description           |
| -------- | -------- | --------------------- |
| `--json` |          | emit response as JSON |

### `ravion deploy continue`

Continue a paused deployment

```bash theme={null}
ravion deploy continue <id> [flags]
```

**Flags:**

| Flag                 | Required | Description                                                                                                                                                                                                                                          |
| -------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--hook-id <string>` |          | Pause-hook id to resolve. Optional — when omitted the deploy workflow targets the hook it is currently paused on (the common case; linear/canary deploys pause once per traffic-shift step, each with a fresh hook id surfaced on the PAUSED event). |
| `--json`             |          | emit response as JSON                                                                                                                                                                                                                                |

### `ravion deploy create`

Create a deployment for a module

```bash theme={null}
ravion deploy create [flags]
```

**Flags:**

| Flag                            | Required | Description                                                             |
| ------------------------------- | -------- | ----------------------------------------------------------------------- |
| `--description <string>`        | yes      | User-provided description shown in dashboards and audit logs. Required. |
| `--module-instance-id <string>` | yes      | Module instance ID                                                      |
| `--inputs <string>`             |          | Deploy-time input values                                                |
| `--json`                        |          | emit response as JSON                                                   |

### `ravion deploy get`

Get Deployment by id

```bash theme={null}
ravion deploy get <id> [flags]
```

**Flags:**

| Flag     | Required | Description           |
| -------- | -------- | --------------------- |
| `--json` |          | emit response as JSON |

### `ravion deploy list`

List Deployments

```bash theme={null}
ravion deploy list [flags]
```

**Flags:**

| Flag                                              | Required | Description                                                                                         |
| ------------------------------------------------- | -------- | --------------------------------------------------------------------------------------------------- |
| `--cursor <string>`                               |          | cursor                                                                                              |
| `--environment-id <string>`                       |          | environmentId                                                                                       |
| `--id <strings>`                                  |          | id                                                                                                  |
| `--json`                                          |          | emit response as JSON                                                                               |
| `--limit <int>`                                   |          | limit                                                                                               |
| `--limit-per-module-instance <moduleInstanceIds>` |          | When set together with moduleInstanceIds, return only the newest N deployments per module instance. |
| `--module-instance-id <string>`                   |          | moduleInstanceId                                                                                    |
| `--module-instance-ids <limit>`                   |          | Return deployments belonging to any of these module instances, newest first, bounded by limit.      |
| `--pipeline-run-id <string>`                      |          | pipelineRunId                                                                                       |
| `--status <strings>`                              |          | Filter to deployments in any of these statuses.                                                     |
| `-v, --verbose`                                   |          | show full output                                                                                    |

### `ravion deploy redeploy`

Redeploy a deployment

```bash theme={null}
ravion deploy redeploy <id> [flags]
```

**Flags:**

| Flag     | Required | Description           |
| -------- | -------- | --------------------- |
| `--json` |          | emit response as JSON |

### `ravion deploy resource`

Manage deployment resources

**Aliases:** `resources`

#### `ravion deploy resource get`

Get DeploymentResource by id

```bash theme={null}
ravion deploy resource get <id> [flags]
```

**Flags:**

| Flag     | Required | Description           |
| -------- | -------- | --------------------- |
| `--json` |          | emit response as JSON |

#### `ravion deploy resource list`

List DeploymentResources

```bash theme={null}
ravion deploy resource list [flags]
```

**Flags:**

| Flag                            | Required | Description           |
| ------------------------------- | -------- | --------------------- |
| `--cursor <string>`             |          | cursor                |
| `--deployment-id <string>`      |          | deploymentId          |
| `--json`                        |          | emit response as JSON |
| `--lifecycle-type <string>`     |          | lifecycleType         |
| `--limit <int>`                 |          | limit                 |
| `--module-instance-id <string>` |          | moduleInstanceId      |
| `--type <string>`               |          | type                  |
| `-v, --verbose`                 |          | show full output      |

### `ravion deploy rollback`

Start a rollback deployment

```bash theme={null}
ravion deploy rollback <id> [flags]
```

**Flags:**

| Flag     | Required | Description           |
| -------- | -------- | --------------------- |
| `--json` |          | emit response as JSON |

### `ravion deploy rollback-candidates`

List rollback candidates

```bash theme={null}
ravion deploy rollback-candidates <id> [flags]
```

**Flags:**

| Flag            | Required | Description           |
| --------------- | -------- | --------------------- |
| `--json`        |          | emit response as JSON |
| `-v, --verbose` |          | show full output      |