• Home
  • Setup and configuration
  • Dynatrace Managed
  • Cluster API
  • Cluster API v1
  • Users v1
  • Create user

Create user

This API call creates a cluster user account.

Authentication

The ServiceProviderAPI (Service Provider API) Api-Token scope is required to get the default realm password policy configuration using the Dynatrace API. With this API method, you can preset user's password by passing passwordClearText value. This is allowed only if a specific Feature Flag is enabled. To do this - contact Dynatrace ONE via help chat or e-mail.

Endpoint

/api/v1.0/onpremise/users

Parameter

ParameterTypeDescriptionInRequired
bodyUserConfig

The JSON body of the request, containing parameters of the user.

bodyoptional

Request body objects

The UserConfig object

The configuration of the user.

ElementTypeDescription
idstring

User ID

emailstring

User's email address

firstNamestring

User's first name

lastNamestring

User's last name

passwordClearTextstring

User's password in a clear text; used only to set initial password

Can be null.

groupsstring[]

List of user's user group IDs.

Can be null.

Request body JSON model

This is a model of the request body, showing the possible elements. It has to be adjusted for usage in an actual request.

json
{
  "id": "string",
  "email": "string",
  "firstName": "string",
  "lastName": "string",
  "passwordClearText": "string",
  "groups": [
    "string"
  ]
}

Response

Response codes

CodeTypeDescription
200UserConfig

Successfully created

400-

Operation failed. The input is invalid. Possible reasons:

  • all required values (ID, email, first name, last name) must be set
  • invalid user data
  • user ID already exists
  • user email address already assigned
  • user group ID does not exist
403-

Operation forbidden - users and groups are fully managed via LDAP or SSO

406-

Unacceptable request

522-

Couldn't create user

523-

User already exists

524-

Email address already registered

Response body objects

The UserConfig object

The configuration of the user.

ElementTypeDescription
idstring

User ID

emailstring

User's email address

firstNamestring

User's first name

lastNamestring

User's last name

passwordClearTextstring

User's password in a clear text; used only to set initial password

Can be null.

groupsstring[]

List of user's user group IDs.

Can be null.

Response body JSON model

json
{
  "id": "string",
  "email": "string",
  "firstName": "string",
  "lastName": "string",
  "passwordClearText": "string",
  "groups": [
    "string"
  ]
}

Example

In this example, you add john.wicked user and assign admins group. As a response, you will receive back persisted state of the entity.

Curl

shell
curl -X PUT "https://myManaged.cluster.com/api/v1.0/onpremise/users" -H  "accept: application/json" -H  "Content-Type: application/json" -d "{\"id\":\"john.wicked\",\"email\":\"john.wicked@company.com\",\"firstName\":\"John\",\"lastName\":\"Wicked\",\"passwordClearText\":null,\"groups\":[\"admin\"]}"

Request URL

plaintext
https://myManaged.cluster.com/api/v1.0/onpremise/users

Response body

json
{
    "id": "john.wicked",
    "email": "john.wicked@company.com",
    "firstName": "John",
    "lastName": "Wicked",
    "passwordClearText": null,
    "groups": [
      "admin"
    ]
  }

Response code

200