Sign in

v1

latestOpenAPI 3.0.02026-07-142351,1971.3 MB
Users

Update a user

Update a user information.

Note: It can only be used with application keys belonging to administrators.

put/api/v1/user/{user_handle}

Path parameters

user_handlestring required
Example:test@datadoghq.com

The ID of the user.

Request body

access_role'st' | 'adm' | 'ro' | 'ERROR' nullable

The access role of the user. Options are st (standard user), adm (admin user), or ro (read-only user).

disabledboolean

The new disabled status of the user.

emailstring

The new email of the user.

handlestring

The user handle, must be a valid email.

iconstring

Gravatar icon associated to the user.

namestring

The name of the user.

verifiedboolean

Whether or not the user logged in Datadog at least once.

Example request

{
  "access_role": "ro",
  "email": "test@datadoghq.com",
  "handle": "test@datadoghq.com",
  "icon": "/path/to/matching/gravatar/icon",
  "name": "test user",
  "verified": true
}

Response

User updated

Example response

{
  "user": {
    "access_role": "ro",
    "email": "test@datadoghq.com",
    "handle": "test@datadoghq.com",
    "icon": "/path/to/matching/gravatar/icon",
    "name": "test user",
    "verified": true
  }
}