> ## 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 project

> Create, list, update, and delete Ravion projects and their settings, including default environments and integrations, from the CLI.

## `ravion project`

Manage projects

**Aliases:** `projects`, `proj`

### `ravion project config`

Manage project config

#### `ravion project config apply`

Apply project config.

\<id> is a project ID or given ID. When it names a project that does not exist yet, the project is created if the config file's project.givenId matches it. Use --dry-run to plan that creation without writing anything.

```bash theme={null}
ravion project config apply <id> [flags]
```

**Flags:**

| Flag | Required | Description |
| - | - | - |
| `--file <string>` | yes | File to read project config from |
| `--autoapprove` | | Pass autoapprove=true to supported stack change pipeline runs |
| `--description <string>` | | Description recorded on every stack run this apply creates, for example a link to the pull request or commit that changed the config |
| `--dry-run` | | Validate and print planned changes without applying them; IDs of resources that do not exist yet print as (known after apply) |
| `--environment-given-id <strings>` | | Environment given ID to include in the apply target set |
| `--environment-id <strings>` | | Environment ID to include in the apply target set |
| `--json` | | emit response as JSON |
| `--module-given-id <strings>` | | Module instance given ID to include within each selected environment |
| `--module-instance-id <strings>` | | Module instance ID to include in the apply target set |
| `--run-ordering <string>` | | Controls whether co-applied module stack runs wait for dependency stack runs to succeed. Available values: dependency, parallel. |

#### `ravion project config pull`

Pull project config

```bash theme={null}
ravion project config pull <id> [flags]
```

**Flags:**

| Flag | Required | Description |
| - | - | - |
| `--file <string>` | yes | File to write project config to |

#### `ravion project config schema`

Print project config file schema

```bash theme={null}
ravion project config schema
```

### `ravion project create`

Create Project

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

**Flags:**

| Flag | Required | Description |
| - | - | - |
| `--given-id <string>` | yes | User-provided project identifier. Must be unique within organization. |
| `--name <string>` | yes | name |
| `--description <string>` | | description |
| `--file <string>` | | File to write project config to |
| `--json` | | emit response as JSON |

### `ravion project delete`

Delete Project

```bash theme={null}
ravion project delete <id> [flags]
```

**Flags:**

| Flag | Required | Description |
| - | - | - |
| `-y, --yes` | | skip confirmation prompt |

### `ravion project get`

Get Project by id

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

**Flags:**

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

### `ravion project list`

List Projects

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

**Flags:**

| Flag | Required | Description |
| - | - | - |
| `--cursor <string>` | | cursor |
| `--json` | | emit response as JSON |
| `--limit <int>` | | limit |
| `-v, --verbose` | | show full output |

### `ravion project update`

Patch Project

```bash theme={null}
ravion project update <id> [flags]
```

**Flags:**

| Flag | Required | Description |
| - | - | - |
| `--description <string>` | | description |
| `--given-id <string>` | | User-provided project identifier. Must be unique within organization. |
| `--json` | | emit response as JSON |
| `--name <string>` | | name |


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