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

# ankra org

> Manage organisations

## ankra org

Commands to list, switch, create, and manage organisations.

## ankra org create

Create a new organisation

```bash theme={null}
ankra org create <name> [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `--country`      |         | Country code for the organisation                     |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |

## ankra org current

Show the currently selected organisation

```bash theme={null}
ankra org current [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |

## ankra org dns

Manage CNAME/A/TXT records under the organisation's own delegated DNS
zone (shown by 'ankra org dns zone'). Records are reconciled asynchronously:
a new or edited record starts in state pending and turns active once it is
published to the authoritative nameservers.

ankra org dns zone
ankra org dns list
ankra org dns add chat CNAME lb-1234.example-lb.com --ttl 300
ankra org dns update chat target.example.com
ankra org dns delete chat

Creating, editing, and deleting records requires organisation admin.

## ankra org dns add

Add a record to the organisation's delegated zone. The name is the label
inside the zone (the zone fqdn is appended server-side), the type is one of
CNAME, A, or TXT, and the content is the record target.

ankra org dns add chat CNAME lb-1234.example-lb.com --ttl 300
ankra org dns add app A 203.0.113.10
ankra org dns add eu TXT "v=spf1 \~all"

```bash theme={null}
ankra org dns add <name> <type> <content> [flags]
```

**Flags**

| Flag    | Default | Description                                    |
| ------- | ------- | ---------------------------------------------- |
| `--ttl` | `0`     | TTL in seconds (30..86400); omitted means Auto |

## ankra org dns delete

Delete a record, referenced by its id or by its name (the label or the
full fqdn). When several records share a name, disambiguate with --type.

```bash theme={null}
ankra org dns delete <record> [flags]
```

**Flags**

| Flag     | Default | Description                                                  |
| -------- | ------- | ------------------------------------------------------------ |
| `--type` |         | Record type (CNAME, A, TXT) to disambiguate a name reference |
| `--yes`  | `false` | Skip the confirmation prompt                                 |

## ankra org dns list

List the organisation's DNS records

```bash theme={null}
ankra org dns list [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |

## ankra org dns update

Re-point a record at new content. The record is referenced by its id or
by its name (the label or the full fqdn); the name and type of a record
never change - delete and re-add to rename. Pass --ttl to change the ttl at
the same time.

```bash theme={null}
ankra org dns update <record> <content> [flags]
```

**Flags**

| Flag     | Default | Description                                                        |
| -------- | ------- | ------------------------------------------------------------------ |
| `--ttl`  | `0`     | TTL in seconds (30..86400); omitted keeps the record's current ttl |
| `--type` |         | Record type (CNAME, A, TXT) to disambiguate a name reference       |

## ankra org dns zone

Show the organisation's delegated DNS zone

```bash theme={null}
ankra org dns zone [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |

## ankra org invite

Invite a user by email to the current organisation.

Valid roles: owner, admin, operator, member (default), viewer, read-only.
owner/operator alias onto admin/member on the invite until the RBAC
assignments API ships; run 'ankra org roles' for the full list.

Examples:
ankra org invite [user@example.com](mailto:user@example.com)
ankra org invite [user@example.com](mailto:user@example.com) --role admin
ankra org invite [user@example.com](mailto:user@example.com) --role viewer

```bash theme={null}
ankra org invite <email> [flags]
```

**Flags**

| Flag     | Default  | Description                                                                   |
| -------- | -------- | ----------------------------------------------------------------------------- |
| `--role` | `member` | Role for the invited user (owner, admin, operator, member, viewer, read-only) |

## ankra org list

List all organisations you belong to

```bash theme={null}
ankra org list [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |

## ankra org members

List members of an organisation

```bash theme={null}
ankra org members [org_id] [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |

## ankra org remove

Remove a user from the current organisation

```bash theme={null}
ankra org remove <user_id> [flags]
```

**Flags**

| Flag            | Default | Description              |
| --------------- | ------- | ------------------------ |
| `-f`, `--force` | `false` | Skip confirmation prompt |

## ankra org roles

List the assignable organisation roles

```bash theme={null}
ankra org roles
```

## ankra org switch

Switch to a different organisation by slug, name, or ID

```bash theme={null}
ankra org switch <organisation>
```

## ankra org variables

Manage organisation-scoped variables that are available to every cluster
in the organisation as template substitutions in stack manifests and addon
values.

ankra org variables list
ankra org variables get DB\_HOST
ankra org variables set DB\_HOST db.prod.example.com --description "Primary database"
ankra org variables delete DB\_HOST

Variable resolution order at deploy time is stack > cluster > organisation; a
more specific scope overrides a less specific one.

## ankra org variables delete

Delete an organisation variable

```bash theme={null}
ankra org variables delete <name> [flags]
```

**Flags**

| Flag    | Default | Description                  |
| ------- | ------- | ---------------------------- |
| `--yes` | `false` | Skip the confirmation prompt |

## ankra org variables get

Get a single organisation variable

```bash theme={null}
ankra org variables get <name> [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |

## ankra org variables list

List all organisation variables

```bash theme={null}
ankra org variables list [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |

## ankra org variables set

Create or update an organisation variable (upsert). If the variable
does not exist it is created; otherwise its value (and description, when
supplied) is updated.

The value can also be read from stdin by passing "-":

echo "secret-token" | ankra org variables set API\_TOKEN -

```bash theme={null}
ankra org variables set <name> <value> [flags]
```

**Flags**

| Flag            | Default | Description                         |
| --------------- | ------- | ----------------------------------- |
| `--description` |         | Optional human-readable description |
