Dynatrace

Dynatrace Platform tokens API

Manage platform tokens for account users.

GitHub OpenAPI
Business capability
Identity & Access Management BC-620.20

Operations 5

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /iam/v1/accounts/{account-uuid}/platform-tokens List platform tokens in an account · Returns platform tokens within account #
Ask an LLM
“Which platform tokens exist in my account and who owns them?”
“Can I search platform tokens by name or filter by status?”
Tell an agent
List platform tokens in account {account}.
Find platform tokens on {account} matching {term} with status {status}.
POST /iam/v1/accounts/{account-uuid}/platform-tokens Create a platform token for a user · Creates platform token for user #
Ask an LLM
“How do I generate a platform token with specific scopes for a user?”
“Can I set an expiration date when creating a platform token?”
Tell an agent
Create platform token {name} for user {user} in {account} with scope {scope} on {resource}, tags {tags}, expiring {expires}.
Generate a token named {name} for {user} on account {account}, scope {scope}, expiring {expires}.
DELETE /iam/v1/accounts/{account-uuid}/platform-tokens/{platform-token-id} Delete a platform token · Deletes platform token #
Ask an LLM
“How do I permanently delete a leaked platform token?”
“Can I remove a platform token from the account entirely?”
Tell an agent destructive · confirm first
Delete platform token {token} from account {account}.
Remove token {token} on {account} permanently.
PUT /iam/v1/accounts/{account-uuid}/platform-tokens/{platform-token-id}/expiration-date Change a platform token's expiration date · Updates platform token expiration data #
Ask an LLM
“Can I extend a platform token before it expires?”
“Is it possible to shorten when an existing token expires?”
Tell an agent
Set platform token {token} in {account} to expire on {expires}.
Extend token {token} on account {account} until {expires}.
PUT /iam/v1/accounts/{account-uuid}/platform-tokens/{platform-token-id}/status Enable or disable a platform token · Updates platform token status #
Ask an LLM
“Can I temporarily disable a platform token without deleting it?”
“What's the way to reactivate a token I switched off?”
Tell an agent
Set the status of platform token {token} in {account} to {status}.
Disable token {token} on account {account} by setting status {status}.

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/dynatrace/refs/heads/main/openapi/dynatrace-platform-tokens-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/dynatrace/refs/heads/main/json-schema/dynatrace-generate-platform-token-form-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/dynatrace/refs/heads/main/json-schema/dynatrace-platform-token-page-dto-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/dynatrace/refs/heads/main/json-schema/dynatrace-platform-token-secret-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/dynatrace/refs/heads/main/json-schema/dynatrace-platform-token-expiration-date-dto-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/dynatrace/refs/heads/main/json-schema/dynatrace-platform-token-status-update-dto-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/dynatrace:dynatrace-platform-tokens-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

dynatrace-platform-tokens-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Dynatrace Account Management Platform Tokens API
  description: The enterprise management API for Dynatrace SaaS enables automation of operational tasks related to user access and environment lifecycle management.
  version: '1.0'
  contact: {}
servers: []
tags:
- name: Platform Tokens
  description: Manage platform tokens for account users.
paths:
  /iam/v1/accounts/{account-uuid}/platform-tokens:
    get:
      operationId: getPlatformTokensForAccount
      parameters:
      - name: account-uuid
        required: true
        in: path
        description: "The ID of the required account. \n\n You can find the UUID on the **Account Management** > **Identity & access management** > **OAuth clients** page, during creation of an OAuth client."
        schema:
          type: string
      - name: searchTerm
        required: false
        in: query
        description: Optional search term. Only platform tokens that match values of tokenId, name, createdBy or scope will be returned.
        schema:
          type: string
      - name: status
        required: false
        in: query
        description: Optional platform token status. Only platform tokens that status matches the value will be returned.
        schema:
          type: string
      - name: page
        required: false
        in: query
        description: The number of the requested page.
        schema:
          type: number
      - name: size
        required: false
        in: query
        description: Defines the requested number of entries for the next page.
        schema:
          type: number
      responses:
        '200':
          description: Successful response - platform tokens fetched.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PlatformTokenPageDto'
      security:
      - bearer: []
      summary: Returns platform tokens within account
      tags:
      - Platform Tokens
      x-token-scopes:
      - platform-token:tokens:manage
    post:
      operationId: generatePlatformToken
      parameters:
      - name: account-uuid
        required: true
        in: path
        description: "The ID of the required account. \n\n You can find the UUID on the **Account Management** > **Identity & access management** > **OAuth clients** page, during creation of an OAuth client."
        schema:
          type: string
      requestBody:
        required: true
        description: Platform token creation form
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GeneratePlatformTokenForm'
      responses:
        '200':
          description: Platform token created successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PlatformTokenSecret'
      security:
      - bearer: []
      summary: Creates platform token for user
      tags:
      - Platform Tokens
      x-token-scopes:
      - platform-token:tokens:manage
  /iam/v1/accounts/{account-uuid}/platform-tokens/{platform-token-id}:
    delete:
      operationId: deletePlatformToken
      parameters:
      - name: account-uuid
        required: true
        in: path
        description: "The ID of the required account. \n\n You can find the UUID on the **Account Management** > **Identity & access management** > **OAuth clients** page, during creation of an OAuth client."
        schema:
          type: string
      - name: platform-token-id
        required: true
        in: path
        schema:
          type: string
      responses:
        '200':
          description: Successful response - platform token deleted.
      security:
      - bearer: []
      summary: Deletes platform token
      tags:
      - Platform Tokens
      x-token-scopes:
      - platform-token:tokens:manage
  /iam/v1/accounts/{account-uuid}/platform-tokens/{platform-token-id}/expiration-date:
    put:
      operationId: updatePlatformTokenExpirationDate
      parameters:
      - name: account-uuid
        required: true
        in: path
        description: "The ID of the required account. \n\n You can find the UUID on the **Account Management** > **Identity & access management** > **OAuth clients** page, during creation of an OAuth client."
        schema:
          type: string
      - name: platform-token-id
        required: true
        in: path
        schema:
          type: string
      requestBody:
        required: true
        description: The JSON body of the request. Contains the new expiration date of platform token
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PlatformTokenExpirationDateDto'
      responses:
        '200':
          description: Successful response - platform tokens fetched.
      security:
      - bearer: []
      summary: Updates platform token expiration data
      tags:
      - Platform Tokens
      x-token-scopes:
      - platform-token:tokens:manage
  /iam/v1/accounts/{account-uuid}/platform-tokens/{platform-token-id}/status:
    put:
      operationId: updatePlatformTokenStatus
      parameters:
      - name: account-uuid
        required: true
        in: path
        description: "The ID of the required account. \n\n You can find the UUID on the **Account Management** > **Identity & access management** > **OAuth clients** page, during creation of an OAuth client."
        schema:
          type: string
      - name: platform-token-id
        required: true
        in: path
        schema:
          type: string
      requestBody:
        required: true
        description: The JSON body of the request. Contains the status the platform token should be changed to.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PlatformTokenStatusUpdateDto'
      responses:
        '204':
          description: Successful response - platform token updated.
      security:
      - bearer: []
      summary: Updates platform token status
      tags:
      - Platform Tokens
      x-token-scopes:
      - platform-token:tokens:manage
components:
  schemas:
    PlatformTokenStatusUpdateDto:
      type: object
      properties:
        status:
          type: string
          enum:
          - ACTIVE
          - INACTIVE
      required:
      - status
    PlatformTokenPageDto:
      type: object
      properties:
        pageSize:
          type: number
          description: Page size.
        pageNumber:
          type: number
          description: Page number.
        total:
          type: number
          description: Total count of entries.
        results:
          type: array
          items:
            $ref: '#/components/schemas/PlatformTokenDto'
      required:
      - pageSize
      - pageNumber
      - total
      - results
    PlatformTokenSecret:
      type: object
      properties:
        name:
          type: string
        tokenId:
          type: string
        token:
          type: string
      required:
      - name
      - tokenId
      - token
    GeneratePlatformTokenForm:
      type: object
      properties:
        name:
          type: string
        scope:
          type: array
          items:
            type: string
        resource:
          type: array
          items:
            type: string
        tags:
          type: array
          items:
            type: string
        expirationDate:
          format: date-time
          type: string
        userUuid:
          type: string
      required:
      - name
      - scope
      - resource
      - tags
      - expirationDate
      - userUuid
    PlatformTokenExpirationDateDto:
      type: object
      properties:
        expirationDate:
          format: date-time
          type: string
      required:
      - expirationDate
    PlatformTokenDto:
      type: object
      properties:
        tokenId:
          type: string
        accountUuid:
          type: number
        description:
          type: string
        name:
          type: string
        scope:
          type: array
          items:
            type: string
        tags:
          type: array
          items:
            type: string
        resource:
          type: array
          items:
            type: string
        expirationDate:
          format: date-time
          type: string
        userUuid:
          type: string
        metadata:
          $ref: '#/components/schemas/PlatformTokenMetadataDto'
      required:
      - tokenId
      - accountUuid
      - description
      - name
      - scope
      - tags
      - resource
      - expirationDate
      - userUuid
      - metadata
    PlatformTokenMetadataDto:
      type: object
      properties:
        lastUsedAt:
          format: date-time
          type: string
        lastClientIp:
          type: string
      required:
      - lastUsedAt
      - lastClientIp
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: JWT
      type: http
externalDocs:
  description: OpenAPI specification
  url: /openapi.json