DAdatadog
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}

Request

  • Base URL
    https://api.datadoghq.com
  • URL
    https://api.datadoghq.com/api/v1/user/{user_handle}
  • Auth
    API key in header DD-API-KEY and API key in header DD-APPLICATION-KEY

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
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.