---
title: Users
description: Create, edit, and disable users.
breadcrumbs: Docs > API > Users
---

> For the complete documentation index, see [llms.txt](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/llms.txt).

# Users

Create, edit, and disable users.

## [Create a user](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/api/latest/users/create-a-user.md)

| Datadog site      | API endpoint                                    |
| ----------------- | ----------------------------------------------- |
| app.datadoghq.com | POST https://api.datadoghq.com/api/v2/users     |
| us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/v2/users |
| us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/v2/users |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/v2/users      |
| ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v2/users |
| ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v2/users |
| uk1.datadoghq.com | POST https://api.uk1.datadoghq.com/api/v2/users |
| app.ddog-gov.com  | POST https://api.ddog-gov.com/api/v2/users      |
| us2.ddog-gov.com  | POST https://api.us2.ddog-gov.com/api/v2/users  |

## [List all users](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/api/latest/users/list-all-users.md)

| Datadog site      | API endpoint                                   |
| ----------------- | ---------------------------------------------- |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/users     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/users |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/users |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/users      |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/users |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/users |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/users |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/users      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/users  |

## [Get user details](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/api/latest/users/get-user-details.md)

| Datadog site      | API endpoint                                             |
| ----------------- | -------------------------------------------------------- |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/users/{user_id}     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/users/{user_id} |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/users/{user_id} |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/users/{user_id}      |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/users/{user_id} |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/users/{user_id} |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/users/{user_id} |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/users/{user_id}      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/users/{user_id}  |

## [Update a user](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/api/latest/users/update-a-user.md)

| Datadog site      | API endpoint                                               |
| ----------------- | ---------------------------------------------------------- |
| app.datadoghq.com | PATCH https://api.datadoghq.com/api/v2/users/{user_id}     |
| us3.datadoghq.com | PATCH https://api.us3.datadoghq.com/api/v2/users/{user_id} |
| us5.datadoghq.com | PATCH https://api.us5.datadoghq.com/api/v2/users/{user_id} |
| app.datadoghq.eu  | PATCH https://api.datadoghq.eu/api/v2/users/{user_id}      |
| ap1.datadoghq.com | PATCH https://api.ap1.datadoghq.com/api/v2/users/{user_id} |
| ap2.datadoghq.com | PATCH https://api.ap2.datadoghq.com/api/v2/users/{user_id} |
| uk1.datadoghq.com | PATCH https://api.uk1.datadoghq.com/api/v2/users/{user_id} |
| app.ddog-gov.com  | PATCH https://api.ddog-gov.com/api/v2/users/{user_id}      |
| us2.ddog-gov.com  | PATCH https://api.us2.ddog-gov.com/api/v2/users/{user_id}  |

## [Disable a user](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/api/latest/users/disable-a-user.md)

| Datadog site      | API endpoint                                                |
| ----------------- | ----------------------------------------------------------- |
| app.datadoghq.com | DELETE https://api.datadoghq.com/api/v2/users/{user_id}     |
| us3.datadoghq.com | DELETE https://api.us3.datadoghq.com/api/v2/users/{user_id} |
| us5.datadoghq.com | DELETE https://api.us5.datadoghq.com/api/v2/users/{user_id} |
| app.datadoghq.eu  | DELETE https://api.datadoghq.eu/api/v2/users/{user_id}      |
| ap1.datadoghq.com | DELETE https://api.ap1.datadoghq.com/api/v2/users/{user_id} |
| ap2.datadoghq.com | DELETE https://api.ap2.datadoghq.com/api/v2/users/{user_id} |
| uk1.datadoghq.com | DELETE https://api.uk1.datadoghq.com/api/v2/users/{user_id} |
| app.ddog-gov.com  | DELETE https://api.ddog-gov.com/api/v2/users/{user_id}      |
| us2.ddog-gov.com  | DELETE https://api.us2.ddog-gov.com/api/v2/users/{user_id}  |

## [Get a user organization](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/api/latest/users/get-a-user-organization.md)

| Datadog site      | API endpoint                                                  |
| ----------------- | ------------------------------------------------------------- |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/users/{user_id}/orgs     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/users/{user_id}/orgs |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/users/{user_id}/orgs |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/users/{user_id}/orgs      |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/users/{user_id}/orgs |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/users/{user_id}/orgs |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/users/{user_id}/orgs |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/users/{user_id}/orgs      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/users/{user_id}/orgs  |

## [Get a user permissions](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/api/latest/users/get-a-user-permissions.md)

| Datadog site      | API endpoint                                                         |
| ----------------- | -------------------------------------------------------------------- |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/users/{user_id}/permissions     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/users/{user_id}/permissions |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/users/{user_id}/permissions |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/users/{user_id}/permissions      |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/users/{user_id}/permissions |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/users/{user_id}/permissions |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/users/{user_id}/permissions |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/users/{user_id}/permissions      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/users/{user_id}/permissions  |

## [Send invitation emails](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/api/latest/users/send-invitation-emails.md)

| Datadog site      | API endpoint                                               |
| ----------------- | ---------------------------------------------------------- |
| app.datadoghq.com | POST https://api.datadoghq.com/api/v2/user_invitations     |
| us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/v2/user_invitations |
| us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/v2/user_invitations |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/v2/user_invitations      |
| ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v2/user_invitations |
| ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v2/user_invitations |
| uk1.datadoghq.com | POST https://api.uk1.datadoghq.com/api/v2/user_invitations |
| app.ddog-gov.com  | POST https://api.ddog-gov.com/api/v2/user_invitations      |
| us2.ddog-gov.com  | POST https://api.us2.ddog-gov.com/api/v2/user_invitations  |

## [Get a user invitation](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/api/latest/users/get-a-user-invitation.md)

| Datadog site      | API endpoint                                                                     |
| ----------------- | -------------------------------------------------------------------------------- |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/user_invitations/{user_invitation_uuid}     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/user_invitations/{user_invitation_uuid} |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/user_invitations/{user_invitation_uuid} |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/user_invitations/{user_invitation_uuid}      |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/user_invitations/{user_invitation_uuid} |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/user_invitations/{user_invitation_uuid} |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/user_invitations/{user_invitation_uuid} |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/user_invitations/{user_invitation_uuid}      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/user_invitations/{user_invitation_uuid}  |

## [Anonymize users](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/api/latest/users/anonymize-users.md) (preview)

| Datadog site      | API endpoint                                             |
| ----------------- | -------------------------------------------------------- |
| app.datadoghq.com | PUT https://api.datadoghq.com/api/v2/anonymize_users     |
| us3.datadoghq.com | PUT https://api.us3.datadoghq.com/api/v2/anonymize_users |
| us5.datadoghq.com | PUT https://api.us5.datadoghq.com/api/v2/anonymize_users |
| app.datadoghq.eu  | PUT https://api.datadoghq.eu/api/v2/anonymize_users      |
| ap1.datadoghq.com | PUT https://api.ap1.datadoghq.com/api/v2/anonymize_users |
| ap2.datadoghq.com | PUT https://api.ap2.datadoghq.com/api/v2/anonymize_users |
| uk1.datadoghq.com | PUT https://api.uk1.datadoghq.com/api/v2/anonymize_users |
| app.ddog-gov.com  | PUT https://api.ddog-gov.com/api/v2/anonymize_users      |
| us2.ddog-gov.com  | PUT https://api.us2.ddog-gov.com/api/v2/anonymize_users  |

## [Delete a pending user's invitations](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/api/latest/users/delete-a-pending-users-invitations.md)

| Datadog site      | API endpoint                                                            |
| ----------------- | ----------------------------------------------------------------------- |
| app.datadoghq.com | DELETE https://api.datadoghq.com/api/v2/users/{user_id}/invitations     |
| us3.datadoghq.com | DELETE https://api.us3.datadoghq.com/api/v2/users/{user_id}/invitations |
| us5.datadoghq.com | DELETE https://api.us5.datadoghq.com/api/v2/users/{user_id}/invitations |
| app.datadoghq.eu  | DELETE https://api.datadoghq.eu/api/v2/users/{user_id}/invitations      |
| ap1.datadoghq.com | DELETE https://api.ap1.datadoghq.com/api/v2/users/{user_id}/invitations |
| ap2.datadoghq.com | DELETE https://api.ap2.datadoghq.com/api/v2/users/{user_id}/invitations |
| uk1.datadoghq.com | DELETE https://api.uk1.datadoghq.com/api/v2/users/{user_id}/invitations |
| app.ddog-gov.com  | DELETE https://api.ddog-gov.com/api/v2/users/{user_id}/invitations      |
| us2.ddog-gov.com  | DELETE https://api.us2.ddog-gov.com/api/v2/users/{user_id}/invitations  |

## [Get current user](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/api/latest/users/get-current-user.md)

| Datadog site      | API endpoint                                          |
| ----------------- | ----------------------------------------------------- |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/current_user     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/current_user |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/current_user |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/current_user      |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/current_user |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/current_user |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/current_user |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/current_user      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/current_user  |

## [Update current user](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/api/latest/users/update-current-user.md)

| Datadog site      | API endpoint                                            |
| ----------------- | ------------------------------------------------------- |
| app.datadoghq.com | PATCH https://api.datadoghq.com/api/v2/current_user     |
| us3.datadoghq.com | PATCH https://api.us3.datadoghq.com/api/v2/current_user |
| us5.datadoghq.com | PATCH https://api.us5.datadoghq.com/api/v2/current_user |
| app.datadoghq.eu  | PATCH https://api.datadoghq.eu/api/v2/current_user      |
| ap1.datadoghq.com | PATCH https://api.ap1.datadoghq.com/api/v2/current_user |
| ap2.datadoghq.com | PATCH https://api.ap2.datadoghq.com/api/v2/current_user |
| uk1.datadoghq.com | PATCH https://api.uk1.datadoghq.com/api/v2/current_user |
| app.ddog-gov.com  | PATCH https://api.ddog-gov.com/api/v2/current_user      |
| us2.ddog-gov.com  | PATCH https://api.us2.ddog-gov.com/api/v2/current_user  |

## [Get identity provider overrides for a user](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/api/latest/users/get-identity-provider-overrides-for-a-user.md)

| Datadog site      | API endpoint                                                                |
| ----------------- | --------------------------------------------------------------------------- |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/users/{user_id}/identity_providers     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/users/{user_id}/identity_providers |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/users/{user_id}/identity_providers |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/users/{user_id}/identity_providers      |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/users/{user_id}/identity_providers |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/users/{user_id}/identity_providers |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/users/{user_id}/identity_providers |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/users/{user_id}/identity_providers      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/users/{user_id}/identity_providers  |

## [Update identity provider overrides for a user](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/api/latest/users/update-identity-provider-overrides-for-a-user.md)

| Datadog site      | API endpoint                                                                                |
| ----------------- | ------------------------------------------------------------------------------------------- |
| app.datadoghq.com | PATCH https://api.datadoghq.com/api/v2/users/{user_id}/relationships/identity_providers     |
| us3.datadoghq.com | PATCH https://api.us3.datadoghq.com/api/v2/users/{user_id}/relationships/identity_providers |
| us5.datadoghq.com | PATCH https://api.us5.datadoghq.com/api/v2/users/{user_id}/relationships/identity_providers |
| app.datadoghq.eu  | PATCH https://api.datadoghq.eu/api/v2/users/{user_id}/relationships/identity_providers      |
| ap1.datadoghq.com | PATCH https://api.ap1.datadoghq.com/api/v2/users/{user_id}/relationships/identity_providers |
| ap2.datadoghq.com | PATCH https://api.ap2.datadoghq.com/api/v2/users/{user_id}/relationships/identity_providers |
| uk1.datadoghq.com | PATCH https://api.uk1.datadoghq.com/api/v2/users/{user_id}/relationships/identity_providers |
| app.ddog-gov.com  | PATCH https://api.ddog-gov.com/api/v2/users/{user_id}/relationships/identity_providers      |
| us2.ddog-gov.com  | PATCH https://api.us2.ddog-gov.com/api/v2/users/{user_id}/relationships/identity_providers  |