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

# Users

| Endpoint                                                                                                          | Method                                                                     |
| ----------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
| [Assign role permissions](/api-reference/membership/users/assign-role-permissions.md)                             | `PUT auth/assign-roles`                                                    |
| [Block user](/api-reference/membership/users/block-user.md)                                                       | `PATCH auth/block`                                                         |
| [Delete user](/api-reference/membership/users/delete-user.md)                                                     | `DELETE auth`                                                              |
| [Get user](/api-reference/membership/users/get-user.md)                                                           | `GET auth/{id}`                                                            |
| [Get user preferences](/api-reference/membership/users/get-user-preferences.md)                                   | `GET auth/{id}/preferences`                                                |
| [Get users](/api-reference/membership/users/get-users.md)                                                         | `GET auth`                                                                 |
| [Grant contact consent](/api-reference/membership/users/grant-contact-consent.md)                                 | `POST users/{contactId}/marketing-state/{channel}/consent`                 |
| [Invite user](/api-reference/membership/users/invite-user.md)                                                     | `POST auth/invite`                                                         |
| [Link identity](/api-reference/membership/users/link-identity.md)                                                 | `POST auth/{userId}/link-identity`                                         |
| [Map auth to user](/api-reference/membership/users/map-auth-to-user.md)                                           | `POST users/{userId}/map-auth`                                             |
| [Save email user](/api-reference/membership/users/save-email-user.md)                                             | `POST auth/register/email`                                                 |
| [Save email user name with permissions](/api-reference/membership/users/save-email-user-name-with-permissions.md) | `POST auth/register/email-with-permissions`                                |
| [Save guest user](/api-reference/membership/users/save-guest-user.md)                                             | `POST auth/register/guest`                                                 |
| [Save phone user](/api-reference/membership/users/save-phone-user.md)                                             | `POST auth/register/phone`                                                 |
| [Save phone user name with permissions](/api-reference/membership/users/save-phone-user-name-with-permissions.md) | `POST auth/register/phone-with-permissions`                                |
| [Save system user with permissions](/api-reference/membership/users/save-system-user-with-permissions.md)         | `POST auth/register/service`                                               |
| [Save user name user](/api-reference/membership/users/save-user-name-user.md)                                     | `POST auth/register/user-name`                                             |
| [Save user name with permissions](/api-reference/membership/users/save-user-name-with-permissions.md)             | `POST auth/register/user-name-with-permissions`                            |
| [Set contact tag subscription](/api-reference/membership/users/set-contact-tag-subscription.md)                   | `PUT users/{contactId}/marketing-state/{commChannel}/{channel}/tags/{tag}` |
| [Unblock user](/api-reference/membership/users/unblock-user.md)                                                   | `PATCH auth/unblock`                                                       |
| [Unsubscribe contact](/api-reference/membership/users/unsubscribe-contact.md)                                     | `POST users/{contactId}/marketing-state/{channel}/unsubscribe`             |
| [Update user](/api-reference/membership/users/update-user.md)                                                     | `PUT auth`                                                                 |
| [Update user preferences](/api-reference/membership/users/update-user-preferences.md)                             | `PUT auth/{id}/preferences`                                                |
| [Add contact identity](/api-reference/membership/users/add-contact-identity.md)                                   | `POST users/{contactId}/identities`                                        |
| [Create contact](/api-reference/membership/users/create-contact.md)                                               | `POST users`                                                               |
| [Delete contact](/api-reference/membership/users/delete-contact.md)                                               | `DELETE users/{contactId}`                                                 |
| [Delete service user api key](/api-reference/membership/users/delete-service-user-api-key.md)                     | `DELETE users/{Id}/api-keys/{KeyId}`                                       |
| [Get all contacts](/api-reference/membership/users/get-all-contacts.md)                                           | `GET users`                                                                |
| [Get contact](/api-reference/membership/users/get-contact.md)                                                     | `GET users/{contactId}`                                                    |
| [Issue service user api key](/api-reference/membership/users/issue-service-user-api-key.md)                       | `POST users/{Id}/api-keys`                                                 |
| [List service user api keys](/api-reference/membership/users/list-service-user-api-keys.md)                       | `GET users/{Id}/api-keys`                                                  |
| [Merge contacts](/api-reference/membership/users/merge-contacts.md)                                               | `POST users/merge`                                                         |
| [Promote contact identity](/api-reference/membership/users/promote-contact-identity.md)                           | `POST users/{contactId}/identities/{identityId}/promote`                   |
| [Remove contact identity](/api-reference/membership/users/remove-contact-identity.md)                             | `DELETE users/{contactId}/identities/{identityId}`                         |
| [Update contact](/api-reference/membership/users/update-contact.md)                                               | `PATCH users/{contactId}`                                                  |