Create users

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/bulk

Parameter

Parameter Type Description In Required
body

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

body optional

Body format

The UserConfig object

The configuration of the user.

Element Type Description Required
id string

User ID

required
email string

User's email address

required
firstName string

User's first name

required
lastName string

User's last name

required
passwordClearText string

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

optional
groups string[]

List of user's user group IDs.

optional

Response

Response codes

Code Description
200

Success

400

Operation failed. The input is invalid. Possible reasons:

  • no user information received for the create-users request
  • all required values (ID, email, first name, last name) must be set
  • invalid user data
  • input contains duplicated IDs
  • input contains duplicated email addresses
  • user ID already exists
  • user email address already assigned
  • user group ID does not exist
403

Operation forbidden - either LDAP or SSO with group assignment integration is turned on

406

Unacceptable or incomplete request. Some users added

Response body

The UserConfig object

The configuration of the user.

Element Type Description
id string

User ID

email string

User's email address

firstName string

User's first name

lastName string

User's last name

passwordClearText string

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

groups string[]

List of user's user group IDs.

Example

In this example, we add two users - john.wicked and ann.brown in a single request. This will set their data and assign individually group memberships. As a response, you will receive back persisted state of the entities.

Curl

curl -X POST "https://myManaged.cluster.com/api/v1.0/onpremise/users/bulk" -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\":[\"owners\",\"users\"]},{\"id\":\"anne.brown\",\"email\":\"anne.brown@company.com\",\"firstName\":\"Anne\",\"lastName\":\"Brown\",\"passwordClearText\":null,\"groups\":[\"users\"]}]"

Request URL

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

Response body

[
  {
    "id": "john.wicked",
    "email": "john.wicked@company.com",
    "firstName": "John",
    "lastName": "Wicked",
    "passwordClearText": null,
    "groups": [
      "owners",
      "users"
    ]
  },
  {
    "id": "anne.brown",
    "email": "anne.brown@company.com",
    "firstName": "Anne",
    "lastName": "Brown",
    "passwordClearText": null,
    "groups": ["users"]
  }
]

Response code

200