# users

Manage users

Aliases:

* user

## Usage [#usage]

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

## Subcommands [#subcommands]

| Name                                                                    | Purpose                                                                               |
| ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| [<code>create</code>](/beta-docs/reference/cli/users_create/)           | Create a new user.                                                                    |
| [<code>list</code>](/beta-docs/reference/cli/users_list/)               | Prints the list of users.                                                             |
| [<code>show</code>](/beta-docs/reference/cli/users_show/)               | Show a single user. Use 'me' to indicate the currently authenticated user.            |
| [<code>delete</code>](/beta-docs/reference/cli/users_delete/)           | Delete a user by username or user\_id.                                                |
| [<code>edit-roles</code>](/beta-docs/reference/cli/users_edit-roles/)   | Edit a user's roles by username or id                                                 |
| [<code>oidc-claims</code>](/beta-docs/reference/cli/users_oidc-claims/) | Display the OIDC claims for the authenticated user.                                   |
| [<code>activate</code>](/beta-docs/reference/cli/users_activate/)       | Update a user's status to 'active'. Active users can fully interact with the platform |
| [<code>suspend</code>](/beta-docs/reference/cli/users_suspend/)         | Update a user's status to 'suspended'. A suspended user cannot log into the platform  |