Manage users programmatically

Learn how to automate Davis Assistant user management using the Davis Assistant API.

General requirements

• A Dynatrace Managed environment
• A valid, enabled Davis Assistant API token with user management permissions
• A system with network access to Davis Assistant on port 443

Authorization

• All requests must include the Authorization header that includes a Davis Assistant API token.

• Create a new Davis Assistant API token in the Davis Assistant API configuration—in Davis Assistant Web, select Configurations from the navigation menu, then Davis Assistant API. Make sure to enable Can manage users when creating the token.

  Note

  If the token is invalid, the API returns a 401 Unauthorized status code. If you're attempting to perform an action that requires administrative privileges for the selected environment and lack these privileges, the API returns a 403 Forbidden status code.

  

GET users

jsoncopydownload
[
  {
    "firstName": "Test",
    "lastName": "One",
    "email": "test.one@dynatrace.com",
    "timezone": "America/Detroit",
    "admin": true
  },
  {
    "firstName": "Test",
    "lastName": "Two",
    "email": "test.two@dynatrace.com",
    "timezone": "America/Detroit",
    "admin": false
  }
]

POST user

jsoncopydownload
{
  "firstName": "Test",
  "lastName": "Three",
  "timezone": "America/Detroit",
  "email": "test.three@dynatrace.com",
  "admin": true
}

PUT user

jsoncopydownload
{
  "admin": true
}

jsoncopydownload
{
  "message": "Successfully updated",
  "changes": [
    "Added admin permission"
  ]
}

DELETE user

jsoncopydownload
{
  "message": "Successfully removed the user"
}