# coder users

Manage users

Aliases:

* user

## Usage [#usage]

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

## Subcommands [#subcommands]

| Name                                                                          | Purpose                                                                                                                                                                                  |
| ----------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [<code>create</code>](/beta-docs/@main/reference/cli/users/create/)           | Create a new user.                                                                                                                                                                       |
| [<code>list</code>](/beta-docs/@main/reference/cli/users/list/)               | Prints the list of users.                                                                                                                                                                |
| [<code>show</code>](/beta-docs/@main/reference/cli/users/show/)               | Show a single user. Use 'me' to indicate the currently authenticated user.                                                                                                               |
| [<code>delete</code>](/beta-docs/@main/reference/cli/users/delete/)           | Delete a user by username or user\_id.                                                                                                                                                   |
| [<code>edit-roles</code>](/beta-docs/@main/reference/cli/users/edit-roles/)   | Edit a user's roles by username or id                                                                                                                                                    |
| [<code>oidc-claims</code>](/beta-docs/@main/reference/cli/users/oidc-claims/) | Display the OIDC claims for the authenticated user.                                                                                                                                      |
| [<code>activate</code>](/beta-docs/@main/reference/cli/users/activate/)       | Update a user's status to 'active'. Active users can fully interact with the platform                                                                                                    |
| [<code>suspend</code>](/beta-docs/@main/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. |