# coder users

Manage users

Aliases:

* user

## Usage

```console
coder users [subcommand]
```

## Subcommands

| Name                                                               | Purpose                                                                                                                                                                                  |
| ------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [<code>create</code>](/docs/reference/cli/users/create/)           | Create a new user.                                                                                                                                                                       |
| [<code>list</code>](/docs/reference/cli/users/list/)               | Prints the list of users.                                                                                                                                                                |
| [<code>show</code>](/docs/reference/cli/users/show/)               | Show a single user. Use 'me' to indicate the currently authenticated user.                                                                                                               |
| [<code>delete</code>](/docs/reference/cli/users/delete/)           | Delete a user by username or user\_id.                                                                                                                                                   |
| [<code>edit-roles</code>](/docs/reference/cli/users/edit-roles/)   | Edit a user's roles by username or id                                                                                                                                                    |
| [<code>oidc-claims</code>](/docs/reference/cli/users/oidc-claims/) | Display the OIDC claims for the authenticated user.                                                                                                                                      |
| [<code>activate</code>](/docs/reference/cli/users/activate/)       | Update a user's status to 'active'. Active users can fully interact with the platform                                                                                                    |
| [<code>suspend</code>](/docs/reference/cli/users/suspend/)         | Update a user's status to 'suspended'. A suspended user cannot log into the platform. Suspending a user stops their running workspaces; activating the user again does not restart them. |