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

# Organization commands

> Manage members, roles, scopes, and storage for your organization

These commands manage your organization's members and access control. They all
operate on your **current organization** (switch with
[`org switch`](/docs/platform-docs/cli/workspace#org-switch)) and are unavailable in
personal workspaces. Service accounts and OIDC trusts have their own pages
([service accounts](/docs/platform-docs/cli/service-account),
[trust](/docs/platform-docs/cli/trust)).

## member

```bash theme={null}
synthetiq member list [--json]
synthetiq member add --email <email> --role-id <role-id>
synthetiq member delete <user-id>
synthetiq member set-role <user-id> --role-id <role-id>
```

Find role IDs with `role list`.

## role

```bash theme={null}
synthetiq role list [--json]
synthetiq role create <name> [--description <text>] [--service-role] [--scope-id <ids...>]
synthetiq role update <role-id> [--name <name>] [--description <text>] [--scope-id <ids...>]
synthetiq role delete <role-id>
```

```
ID                                     NAME                 TYPE      DEFAULT   SCOPES
91c2b54f-…                             CI Provision Apply   service             4
d2e74c81-…                             Member               member    *         12
```

| Flag                   | Description                                                                    |
| ---------------------- | ------------------------------------------------------------------------------ |
| `--description <text>` | What the role is for; on `update`, pass `""` to clear it                       |
| `--service-role`       | Create a service role (for service accounts)                                   |
| `--scope-id <ids...>`  | Scope IDs to grant (see `scope list`); on `update`, replaces the role's scopes |

## scope

```bash theme={null}
synthetiq scope list [--json]
```

Lists the assignable permission scopes you reference when building roles.

## storage-config

Manage the organization's external (BYO) storage for entity packages.

```bash theme={null}
synthetiq storage-config get [--json]
synthetiq storage-config set --provider <p> --bucket-name <b> [--endpoint <url>] [--region <r>]
synthetiq storage-config delete [--force]
```

`delete` reverts the organization to managed storage. Prompts for confirmation unless `--force`.