> For the complete documentation index, see [llms.txt](https://codemash.gitbook.io/codemash/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://codemash.gitbook.io/codemash/cli/reference/users.md).

# norbix users

Manage project users (membership).

Manage project users (membership).

8 commands (`@norbix.ai/cli` 1.16.0):

* [`norbix users block`](#norbix-users-block) — Block a user (they can no longer log in)
* [`norbix users delete`](#norbix-users-delete) — Delete a user
* [`norbix users get`](#norbix-users-get) — Show one user
* [`norbix users invite`](#norbix-users-invite) — Invite a user by email
* [`norbix users list`](#norbix-users-list) — List project users
* [`norbix users policies`](#norbix-users-policies) — List membership policies
* [`norbix users roles`](#norbix-users-roles) — List membership roles
* [`norbix users unblock`](#norbix-users-unblock) — Unblock a user

## `norbix users block`

Block a user (they can no longer log in)

```sh
norbix users block ID [flags]
```

| Argument | Required | Description |
| -------- | -------- | ----------- |
| `ID`     | yes      | User ID     |

| Flag          | Description                                                            |
| ------------- | ---------------------------------------------------------------------- |
| `-y`, `--yes` | Skip the confirmation prompt (required in non-interactive shells)      |
| `--dry-run`   | Resolve context and print the request that would be sent; send nothing |

Also takes the [global flags](/codemash/cli/reference.md#global-flags): `--json`, `--project`, `--env`, `--region`, `--api-key`, `--account`, `--profile`.

Examples:

```sh
norbix users block 66b2f0a1c3d4e5f6a7b8c9d0 --dry-run
norbix users block 66b2f0a1c3d4e5f6a7b8c9d0 --yes
```

## `norbix users delete`

Delete a user

```sh
norbix users delete ID [flags]
```

| Argument | Required | Description |
| -------- | -------- | ----------- |
| `ID`     | yes      | User ID     |

| Flag          | Description                                                            |
| ------------- | ---------------------------------------------------------------------- |
| `-y`, `--yes` | Skip the confirmation prompt (required in non-interactive shells)      |
| `--dry-run`   | Resolve context and print the request that would be sent; send nothing |

Also takes the [global flags](/codemash/cli/reference.md#global-flags): `--json`, `--project`, `--env`, `--region`, `--api-key`, `--account`, `--profile`.

Examples:

```sh
norbix users delete 66b2f0a1c3d4e5f6a7b8c9d0 --yes
norbix users delete 66b2f0a1c3d4e5f6a7b8c9d0 --dry-run
```

## `norbix users get`

Show one user

```sh
norbix users get ID
```

| Argument | Required | Description |
| -------- | -------- | ----------- |
| `ID`     | yes      | User ID     |

Also takes the [global flags](/codemash/cli/reference.md#global-flags): `--json`, `--project`, `--env`, `--region`, `--api-key`, `--account`, `--profile`.

Examples:

```sh
norbix users get 66b2f0a1c3d4e5f6a7b8c9d0
```

## `norbix users invite`

Invite a user by email

```sh
norbix users invite EMAIL [flags]
```

| Argument | Required | Description             |
| -------- | -------- | ----------------------- |
| `EMAIL`  | yes      | Email address to invite |

| Flag        | Description                                                            |
| ----------- | ---------------------------------------------------------------------- |
| `--dry-run` | Resolve context and print the request that would be sent; send nothing |

Also takes the [global flags](/codemash/cli/reference.md#global-flags): `--json`, `--project`, `--env`, `--region`, `--api-key`, `--account`, `--profile`.

Examples:

```sh
norbix users invite alice@example.com
norbix users invite alice@example.com --dry-run
```

## `norbix users list`

List project users

```sh
norbix users list [flags]
```

| Flag                    | Description                                                 |
| ----------------------- | ----------------------------------------------------------- |
| `--role` `<value>`      | Only users with this role (repeatable) — repeat for several |
| `--permissions`         | Include permissions in the output                           |
| `--page-size` `<value>` | Records per page                                            |
| `--after` `<value>`     | Cursor: fetch the page after this item                      |

Also takes the [global flags](/codemash/cli/reference.md#global-flags): `--json`, `--project`, `--env`, `--region`, `--api-key`, `--account`, `--profile`.

Examples:

```sh
norbix users list
norbix users list --role admin --page-size 100
```

## `norbix users policies`

List membership policies

```sh
norbix users policies
```

Also takes the [global flags](/codemash/cli/reference.md#global-flags): `--json`, `--project`, `--env`, `--region`, `--api-key`, `--account`, `--profile`.

Examples:

```sh
norbix users policies
```

## `norbix users roles`

List membership roles

```sh
norbix users roles
```

Also takes the [global flags](/codemash/cli/reference.md#global-flags): `--json`, `--project`, `--env`, `--region`, `--api-key`, `--account`, `--profile`.

Examples:

```sh
norbix users roles
```

## `norbix users unblock`

Unblock a user

```sh
norbix users unblock ID [flags]
```

| Argument | Required | Description |
| -------- | -------- | ----------- |
| `ID`     | yes      | User ID     |

| Flag        | Description                                                            |
| ----------- | ---------------------------------------------------------------------- |
| `--dry-run` | Resolve context and print the request that would be sent; send nothing |

Also takes the [global flags](/codemash/cli/reference.md#global-flags): `--json`, `--project`, `--env`, `--region`, `--api-key`, `--account`, `--profile`.

Examples:

```sh
norbix users unblock 66b2f0a1c3d4e5f6a7b8c9d0
norbix users unblock 66b2f0a1c3d4e5f6a7b8c9d0 --dry-run
```