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

# dome tenants

> List, inspect, and create tenants under your active organization

Manage tenants in your organization. List, get, and create are gated on the org-level `tenant.manage` permission (held by org `admin` or `owner`); `get` additionally admits any caller whose active session is scoped to the requested tenant.

## List

`dome tenants list`

List tenants under your active organization.

| Flag       | Type   | Required | Description                                            |
| ---------- | ------ | -------- | ------------------------------------------------------ |
| `--org-id` | string | No       | Target org UUID. Defaults to the active context's org. |

**Permission:** Org-level `tenant.manage` (held by org `owner` or `admin`).

```bash title="List tenants in the active org" theme={"system"}
dome tenants list
```

```bash title="Target a specific org" theme={"system"}
dome tenants list --org-id 7d2c…
```

Output is a table of `ID`, `NAME`, `PLAN`, and `CREATED`. Pass `--format json` for the raw response.

## Get

`dome tenants get <tenant-id>`

Get a single tenant by id. The caller is admitted if either (a) their active session is scoped to the requested tenant, or (b) they hold org `admin` or `owner` on the requested tenant's org.

| Argument / Flag | Type   | Required | Description                                            |
| --------------- | ------ | -------- | ------------------------------------------------------ |
| `<tenant-id>`   | string | Yes      | Tenant UUID                                            |
| `--org-id`      | string | No       | Target org UUID. Defaults to the active context's org. |

**Permission:** Tenant-scoped session for the requested tenant **or** org-level `tenant.manage` on the requested tenant's org.

```bash title="Get a tenant in the active org" theme={"system"}
dome tenants get 5b1e…
```

```bash title="Get a tenant from a specific org" theme={"system"}
dome tenants get 5b1e… --org-id 7d2c…
```

Output is a key/value table including ID, name, plan, org id, default gateway, and created timestamp. Pass `--format json` for the raw response.

## Create

`dome tenants create`

Create a new tenant under your active organization. The caller becomes the initial tenant admin.

| Flag       | Type   | Required | Description                                                             |
| ---------- | ------ | -------- | ----------------------------------------------------------------------- |
| `--name`   | string | Yes      | Tenant display name                                                     |
| `--plan`   | string | No       | Tenant plan: `essential` (default), `managed`, `enterprise`, `complete` |
| `--org-id` | string | No       | Target org UUID. Defaults to the active context's org.                  |

**Permission:** Org-level `tenant.manage` on the org named in `--org-id` (held by org `owner` or `admin`). The permission check runs against the request's target org, not your active context — a caller authorized on org X cannot create a tenant in org Y by overriding `--org-id`.

```bash title="Create a tenant under the active org" theme={"system"}
dome tenants create --name acme-prod --plan managed
```

```bash title="Target a specific org" theme={"system"}
dome tenants create --name acme-staging --org-id 7d2c…
```

<Note>
  `dome tenants create` works directly after `dome auth login` — no prior `dome use` is required. As long as `--org-id` (or the default active org) names an org you hold `tenant.manage` on, the request succeeds.
</Note>

<Note>
  Creating a new organization is operator-only. Contact Dome to provision a new org.
</Note>