For AI agents: A markdown version of this page is available at https://docs.datadoghq.com/api/latest/users.md. A documentation index is available at /llms.txt.

Language

English Français 日本語 한국어 Español

Datadog Site

Site help
US1 US3 US5 EU AP1 AP2 UK1 US1-FED US2-FED

Users

copy Copy pageCopied

Create, edit, and disable users.

Create a user →

POST https://api.ap1.datadoghq.com/api/v2/usershttps://api.ap2.datadoghq.com/api/v2/usershttps://api.datadoghq.eu/api/v2/usershttps://api.ddog-gov.com/api/v2/usershttps://api.us2.ddog-gov.com/api/v2/usershttps://api.uk1.datadoghq.com/api/v2/usershttps://api.datadoghq.com/api/v2/usershttps://api.us3.datadoghq.com/api/v2/usershttps://api.us5.datadoghq.com/api/v2/users

List all users →

GET https://api.ap1.datadoghq.com/api/v2/usershttps://api.ap2.datadoghq.com/api/v2/usershttps://api.datadoghq.eu/api/v2/usershttps://api.ddog-gov.com/api/v2/usershttps://api.us2.ddog-gov.com/api/v2/usershttps://api.uk1.datadoghq.com/api/v2/usershttps://api.datadoghq.com/api/v2/usershttps://api.us3.datadoghq.com/api/v2/usershttps://api.us5.datadoghq.com/api/v2/users

Get user details →

GET https://api.ap1.datadoghq.com/api/v2/users/{user_id}https://api.ap2.datadoghq.com/api/v2/users/{user_id}https://api.datadoghq.eu/api/v2/users/{user_id}https://api.ddog-gov.com/api/v2/users/{user_id}https://api.us2.ddog-gov.com/api/v2/users/{user_id}https://api.uk1.datadoghq.com/api/v2/users/{user_id}https://api.datadoghq.com/api/v2/users/{user_id}https://api.us3.datadoghq.com/api/v2/users/{user_id}https://api.us5.datadoghq.com/api/v2/users/{user_id}

Update a user →

PATCH https://api.ap1.datadoghq.com/api/v2/users/{user_id}https://api.ap2.datadoghq.com/api/v2/users/{user_id}https://api.datadoghq.eu/api/v2/users/{user_id}https://api.ddog-gov.com/api/v2/users/{user_id}https://api.us2.ddog-gov.com/api/v2/users/{user_id}https://api.uk1.datadoghq.com/api/v2/users/{user_id}https://api.datadoghq.com/api/v2/users/{user_id}https://api.us3.datadoghq.com/api/v2/users/{user_id}https://api.us5.datadoghq.com/api/v2/users/{user_id}

Disable a user →

DELETE https://api.ap1.datadoghq.com/api/v2/users/{user_id}https://api.ap2.datadoghq.com/api/v2/users/{user_id}https://api.datadoghq.eu/api/v2/users/{user_id}https://api.ddog-gov.com/api/v2/users/{user_id}https://api.us2.ddog-gov.com/api/v2/users/{user_id}https://api.uk1.datadoghq.com/api/v2/users/{user_id}https://api.datadoghq.com/api/v2/users/{user_id}https://api.us3.datadoghq.com/api/v2/users/{user_id}https://api.us5.datadoghq.com/api/v2/users/{user_id}

Get a user organization →

GET https://api.ap1.datadoghq.com/api/v2/users/{user_id}/orgshttps://api.ap2.datadoghq.com/api/v2/users/{user_id}/orgshttps://api.datadoghq.eu/api/v2/users/{user_id}/orgshttps://api.ddog-gov.com/api/v2/users/{user_id}/orgshttps://api.us2.ddog-gov.com/api/v2/users/{user_id}/orgshttps://api.uk1.datadoghq.com/api/v2/users/{user_id}/orgshttps://api.datadoghq.com/api/v2/users/{user_id}/orgshttps://api.us3.datadoghq.com/api/v2/users/{user_id}/orgshttps://api.us5.datadoghq.com/api/v2/users/{user_id}/orgs

Get a user permissions →

GET https://api.ap1.datadoghq.com/api/v2/users/{user_id}/permissionshttps://api.ap2.datadoghq.com/api/v2/users/{user_id}/permissionshttps://api.datadoghq.eu/api/v2/users/{user_id}/permissionshttps://api.ddog-gov.com/api/v2/users/{user_id}/permissionshttps://api.us2.ddog-gov.com/api/v2/users/{user_id}/permissionshttps://api.uk1.datadoghq.com/api/v2/users/{user_id}/permissionshttps://api.datadoghq.com/api/v2/users/{user_id}/permissionshttps://api.us3.datadoghq.com/api/v2/users/{user_id}/permissionshttps://api.us5.datadoghq.com/api/v2/users/{user_id}/permissions

Send invitation emails →

POST https://api.ap1.datadoghq.com/api/v2/user_invitationshttps://api.ap2.datadoghq.com/api/v2/user_invitationshttps://api.datadoghq.eu/api/v2/user_invitationshttps://api.ddog-gov.com/api/v2/user_invitationshttps://api.us2.ddog-gov.com/api/v2/user_invitationshttps://api.uk1.datadoghq.com/api/v2/user_invitationshttps://api.datadoghq.com/api/v2/user_invitationshttps://api.us3.datadoghq.com/api/v2/user_invitationshttps://api.us5.datadoghq.com/api/v2/user_invitations

Get a user invitation →

GET https://api.ap1.datadoghq.com/api/v2/user_invitations/{user_invitation_uuid}https://api.ap2.datadoghq.com/api/v2/user_invitations/{user_invitation_uuid}https://api.datadoghq.eu/api/v2/user_invitations/{user_invitation_uuid}https://api.ddog-gov.com/api/v2/user_invitations/{user_invitation_uuid}https://api.us2.ddog-gov.com/api/v2/user_invitations/{user_invitation_uuid}https://api.uk1.datadoghq.com/api/v2/user_invitations/{user_invitation_uuid}https://api.datadoghq.com/api/v2/user_invitations/{user_invitation_uuid}https://api.us3.datadoghq.com/api/v2/user_invitations/{user_invitation_uuid}https://api.us5.datadoghq.com/api/v2/user_invitations/{user_invitation_uuid}

Anonymize users → preview

PUT https://api.ap1.datadoghq.com/api/v2/anonymize_usershttps://api.ap2.datadoghq.com/api/v2/anonymize_usershttps://api.datadoghq.eu/api/v2/anonymize_usershttps://api.ddog-gov.com/api/v2/anonymize_usershttps://api.us2.ddog-gov.com/api/v2/anonymize_usershttps://api.uk1.datadoghq.com/api/v2/anonymize_usershttps://api.datadoghq.com/api/v2/anonymize_usershttps://api.us3.datadoghq.com/api/v2/anonymize_usershttps://api.us5.datadoghq.com/api/v2/anonymize_users

Delete a pending user's invitations →

DELETE https://api.ap1.datadoghq.com/api/v2/users/{user_id}/invitationshttps://api.ap2.datadoghq.com/api/v2/users/{user_id}/invitationshttps://api.datadoghq.eu/api/v2/users/{user_id}/invitationshttps://api.ddog-gov.com/api/v2/users/{user_id}/invitationshttps://api.us2.ddog-gov.com/api/v2/users/{user_id}/invitationshttps://api.uk1.datadoghq.com/api/v2/users/{user_id}/invitationshttps://api.datadoghq.com/api/v2/users/{user_id}/invitationshttps://api.us3.datadoghq.com/api/v2/users/{user_id}/invitationshttps://api.us5.datadoghq.com/api/v2/users/{user_id}/invitations

Get current user →

GET https://api.ap1.datadoghq.com/api/v2/current_userhttps://api.ap2.datadoghq.com/api/v2/current_userhttps://api.datadoghq.eu/api/v2/current_userhttps://api.ddog-gov.com/api/v2/current_userhttps://api.us2.ddog-gov.com/api/v2/current_userhttps://api.uk1.datadoghq.com/api/v2/current_userhttps://api.datadoghq.com/api/v2/current_userhttps://api.us3.datadoghq.com/api/v2/current_userhttps://api.us5.datadoghq.com/api/v2/current_user

Update current user →

PATCH https://api.ap1.datadoghq.com/api/v2/current_userhttps://api.ap2.datadoghq.com/api/v2/current_userhttps://api.datadoghq.eu/api/v2/current_userhttps://api.ddog-gov.com/api/v2/current_userhttps://api.us2.ddog-gov.com/api/v2/current_userhttps://api.uk1.datadoghq.com/api/v2/current_userhttps://api.datadoghq.com/api/v2/current_userhttps://api.us3.datadoghq.com/api/v2/current_userhttps://api.us5.datadoghq.com/api/v2/current_user

Get identity provider overrides for a user →

GET https://api.ap1.datadoghq.com/api/v2/users/{user_id}/identity_providershttps://api.ap2.datadoghq.com/api/v2/users/{user_id}/identity_providershttps://api.datadoghq.eu/api/v2/users/{user_id}/identity_providershttps://api.ddog-gov.com/api/v2/users/{user_id}/identity_providershttps://api.us2.ddog-gov.com/api/v2/users/{user_id}/identity_providershttps://api.uk1.datadoghq.com/api/v2/users/{user_id}/identity_providershttps://api.datadoghq.com/api/v2/users/{user_id}/identity_providershttps://api.us3.datadoghq.com/api/v2/users/{user_id}/identity_providershttps://api.us5.datadoghq.com/api/v2/users/{user_id}/identity_providers

Update identity provider overrides for a user →

PATCH https://api.ap1.datadoghq.com/api/v2/users/{user_id}/relationships/identity_providershttps://api.ap2.datadoghq.com/api/v2/users/{user_id}/relationships/identity_providershttps://api.datadoghq.eu/api/v2/users/{user_id}/relationships/identity_providershttps://api.ddog-gov.com/api/v2/users/{user_id}/relationships/identity_providershttps://api.us2.ddog-gov.com/api/v2/users/{user_id}/relationships/identity_providershttps://api.uk1.datadoghq.com/api/v2/users/{user_id}/relationships/identity_providershttps://api.datadoghq.com/api/v2/users/{user_id}/relationships/identity_providershttps://api.us3.datadoghq.com/api/v2/users/{user_id}/relationships/identity_providershttps://api.us5.datadoghq.com/api/v2/users/{user_id}/relationships/identity_providers