> ## 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 service-account

> Create and manage Ravion service accounts and their API keys for CI, automation, and AI-agent access using the `ravion service-account` commands.

## `ravion service-account`

Manage service accounts

**Aliases:** `service-accounts`

### `ravion service-account create`

Create ServiceAccount

```bash theme={null}
ravion service-account create [flags]
```

**Flags:**

| Flag                     | Required | Description                                                                              |
| ------------------------ | -------- | ---------------------------------------------------------------------------------------- |
| `--name <string>`        | yes      | User-facing service account name.                                                        |
| `--role <string>`        | yes      | Organization role used when this service account authenticates. Available values: OWNER. |
| `--description <string>` |          | Optional context for what this service account is used for.                              |
| `--json`                 |          | emit response as JSON                                                                    |

### `ravion service-account delete`

Delete ServiceAccount

```bash theme={null}
ravion service-account delete <id> [flags]
```

**Flags:**

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

### `ravion service-account get`

Get ServiceAccount by id

```bash theme={null}
ravion service-account get <id> [flags]
```

**Flags:**

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

### `ravion service-account list`

List ServiceAccounts

```bash theme={null}
ravion service-account list [flags]
```

**Flags:**

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

### `ravion service-account update`

Patch ServiceAccount

```bash theme={null}
ravion service-account update <id> [flags]
```

**Flags:**

| Flag                     | Required | Description                                                                              |
| ------------------------ | -------- | ---------------------------------------------------------------------------------------- |
| `--description <string>` |          | Optional context for what this service account is used for.                              |
| `--json`                 |          | emit response as JSON                                                                    |
| `--name <string>`        |          | User-facing service account name.                                                        |
| `--role <string>`        |          | Organization role used when this service account authenticates. Available values: OWNER. |