v1

latestOpenAPI 3.0.02026-07-141,4077,1665.2 MB

Key Management

Create a personal access token

Create a personal access token for the current user.

post/api/v2/personal_access_tokens

Request body

Example request

{
  "data": {
    "attributes": {
      "expires_at": "2025-12-31T23:59:59+00:00",
      "name": "My Personal Access Token",
      "scopes": [
        "dashboards_read",
        "dashboards_write"
      ]
    },
    "type": "personal_access_tokens"
  }
}

Response

Created

Example response

{
  "data": {
    "attributes": {
      "created_at": "2024-01-01T00:00:00+00:00",
      "expires_at": "2025-12-31T23:59:59+00:00",
      "name": "My Access Token",
      "public_portion": "ddpat_abc123",
      "scopes": [
        "dashboards_read",
        "dashboards_write"
      ]
    },
    "relationships": {
      "owned_by": {
        "data": {
          "id": "00000000-0000-0000-2345-000000000000",
          "type": "users"
        }
      }
    },
    "type": "personal_access_tokens"
  }
}