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

# Members

> The people who have access to the workspace. Only first and last names can be changed, not email addresses; admins cannot be removed from the command line.

`reachboost users` has 4 commands. Each one lists its arguments, its flags and what it is allowed to change.

Read-only

Changes data

Needs --yes and --confirm-name

Every command also accepts the [global flags](https://docs.reachboost.io/cli/commands.md#global-flags).

## users get

Read-only

Get a workspace member. Read-only.

```bash Usage theme={null}
reachboost users get "<user-uuid>"
```

**Arguments**

**\<user-uuid>** `uuid` *required*

The unique identifier for the workspace member.

## users list

Read-only

List workspace members. Read-only. The people who have access to the workspace, newest first. Filters combine with AND across fields. `first_name`, `last_name` and `email` match partial, case-insensitive text. `role` matches exactly; give several values separated by commas to match any of them. Unknown filter values apply no restriction.

```bash Usage theme={null}
reachboost users list
```

**Flags**

**--page \<n>** `number`

The page number.

**--per-page \<n>** `number`

The number of results per page.

**--first-name \<text>** `string`

Partial match filter on the first name (case-insensitive).

**--last-name \<text>** `string`

Partial match filter on the last name (case-insensitive).

**--email \<text>** `string`

Partial match filter on the email address (case-insensitive).

**--role \<text>** `string`

Exact match on the role, one or more of `workspace_member`, `workspace_admin`, `agency_member`, `agency_admin` separated by commas.

**--all** `boolean`

Fetch every page (up to 200 pages of 100) instead of one. Cannot be combined with --page.

## users delete

Needs --yes and --confirm-name

Remove a workspace member. Irreversible: needs --yes and --confirm-name. Removes the member and the invitations they sent, in this workspace and in any other workspace they invited into, and drops them from the access list of every workspace they were given access to. Admins cannot be removed through the API, and neither can the last admin of the workspace; both answer 422 with a message.

> [!CAUTION]
>
> Cannot be undone. Needs `--yes` and `--confirm-name`. See [Safety](https://docs.reachboost.io/cli/safety.md#--confirm-name).

```bash Usage theme={null}
reachboost users delete "<user-uuid>"
```

**Arguments**

**\<user-uuid>** `uuid` *required*

The unique identifier for the workspace member.

**Flags**

**--dry-run** `boolean`

Show exactly what would be sent, and send nothing.

**--yes** `boolean`

Confirm. Without it the command shows what it would do and stops.

**--confirm-name \<name>** `string`

The exact member email, repeated as a check that this is the right target. Cannot be undone.

## users update

Changes data

Update a workspace member. Changes data. Changes the member's first or last name. Nothing else is writable here: an email address, a role, a uuid or a timestamp in the body is refused with `422`. The email address stays out of reach on purpose, since whoever could change it could request a password reset to the new address and take the account over.

```bash Usage theme={null}
reachboost users update "<user-uuid>"
```

**Arguments**

**\<user-uuid>** `uuid` *required*

The unique identifier for the workspace member.

**Flags**

**--first-name \<text>** `string`

**--last-name \<text>** `string`

**--body \<json>** `JSON`

The whole request body as JSON, instead of individual flags.

**--body-file \<path>** `path`

Read the whole request body as JSON from a file, or from stdin with -.

**--dry-run** `boolean`

Show exactly what would be sent, and send nothing.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.