Platform tokens API - PUT a platform token expiration date

  • Latest Dynatrace
  • Reference
  • Published Dec 04, 2025

Updates the expiration date of a platform token in an account.

The request consumes an application/json payload.

PUT

https://api.dynatrace.com/iam/v1/accounts/{accountUuid}/platform-tokens/{platformTokenId}/expiration-date

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
platformTokenIdstring-pathRequired
bodyPlatformTokenExpirationDateDto

The JSON body of the request. Contains the new expiration date of platform token

bodyRequired

Request body objects

The PlatformTokenExpirationDateDto object

ElementTypeDescriptionRequired
expirationDatestring-Required

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.

{
  "expirationDate": "string"
}

Response

Response codes

CodeDescription
200

Successful response - platform tokens fetched.

Example

In this example, the request updates the expiration date of a platform token. It updates a platform token with tokenId dt0s16.TYUHJKNM for the account with accountUuid 2b794097-8ad2-4b32-b923-0131da2eeddf.

Curl

curl -X 'PUT' \
  'https://api-dev.internal.dynatracelabs.com/iam/v1/accounts/2b794097-8ad2-4b32-b923-0131da2eeddf/platform-tokens/dt0s16.TYUHJKNM/expiration-date' \
  -H 'accept: */*' \
  -H 'Authorization: Bearer eywedGciOiJFUzI1NiIsInR7cCI6IkpCDVIsImtpZCI6IjEifQ' \
  -H 'Content-Type: application/json' \
  -d '{
  "expirationDate": "2025-06-21T08:10:30.369Z"
}'

Request URL

https://api-dev.internal.dynatracelabs.com/iam/v1/accounts/2b794097-8ad2-4b32-b923-0131da2eeddf/platform-tokens/dt0s16.TYUHJKNM/expiration-date

Request body

{
  "expirationDate": "2025-06-21T08:10:30.369Z"
}

Response code

200