Service user management API - PUT a service user

  • Latest Dynatrace
  • Reference
  • Published Dec 04, 2025

Updates the details of a service user.

The request consumes an application/json payload.

PUT

https://api.dynatrace.com/iam/v1/accounts/{accountUuid}/service-users/{userUuid}

Authentication

To execute this request, you need the Allow write access for identity resources (users and groups) (account-idm-write) scope assigned to your token. To learn how to obtain and use it, see OAuth clients.

Parameters

ParameterTypeDescriptionInRequired
accountUuidstring

The ID of the required account.

You can find the UUID on the Account Management > Identity & access management > OAuth clients page, during creation of an OAuth client.

pathRequired
userUuidstring

The UUID of the required user.

pathRequired
bodyServiceUserDto

The JSON body of the request. Contains changed name and description of the service user.

bodyRequired

Request body objects

The ServiceUserDto object

ElementTypeDescriptionRequired
namestring

The name of the new service user

Required
descriptionstring

The description of the new service user

Optional

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.

{
"name": "string",
"description": "string"
}

Response

Response codes

CodeDescription
default

Success. The service user has been updated.

Example

In this example, the request updates a service user with userUuid e2dbb9d3-1a2b-4cde-9f01-23456789abcd for the account with accountUuid 2b794097-8ad2-4b32-b923-0131da2eeddf.

Curl

curl -X 'PUT' \
'https://api.dynatrace.com/iam/v1/accounts/2b794097-8ad2-4b32-b923-0131da2eeddf/service-users/e2dbb9d3-1a2b-4cde-9f01-23456789abcd' \
-H 'accept: */*' \
-H 'Authorization: Bearer eywedGciOiJFUzI1NiIsInR7cCI6IkpCDVIsImtpZCI6IjEifQ' \
-H 'Content-Type: application/json' \
-d '{
"name": "serviceUser12",
"description": "update Service User12"
}'

Request URL

https://api.dynatrace.com/iam/v1/accounts/2b794097-8ad2-4b32-b923-0131da2eeddf/service-users/e2dbb9d3-1a2b-4cde-9f01-23456789abcd

Request body

{
"uuid": "e2dbb9d3-1a2b-4cde-9f01-23456789abcd",
"name": "serviceUser12",
"description": "update Service User12",
"federatedAttributeValues": [
]
}

Response code

200