Sign in

v1

latestOpenAPI 3.0.02026-07-142351,1971.3 MB
Users

Create a user

Create a user for your organization.

Note: Users can only be created with the admin access role if application keys belong to administrators.

post/api/v1/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 created

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