Regenerate API token

POST/v2/tokens/{id}/regenerate

Creates a new API token with the existing token's capabilities, or with those in newToken, and returns its secret value. The existing token keeps working until existingTokenExpiresAt; set it to the current time to revoke it immediately.

Parameters

Property	Type	Location	Description
`id`	`string`Required	`path`

Body

application/json

Property	Type	Description
`existingTokenExpiresAt`	`string<date-time>`Required	Expiration date of the existing token (ISO 8601 format)
`newToken`	`object`
`datasetCapabilities`	`object`
`description`	`string`	Description of the token
`expiresAt`	`string<date-time>`	Expiration date of the token (ISO 8601 format)
`name`	`string`Required	Name of the token
`orgCapabilities`	`object`
`annotations`	`string[]`	Annotations capability
`apiTokens`	`string[]`	API tokens capability
`auditLog`	`string[]`	Audit Log capability
`billing`	`string[]`	Billing capability
`dashboards`	`string[]`	Dashboards capability
`datasets`	`string[]`	Datasets capability
`endpoints`	`string[]`	Endpoints capability
`integrations`	`string[]`	Integrations capability
`labels`	`string[]`	Labels capability
`monitors`	`string[]`	Monitors capability
`notifiers`	`string[]`	Notifiers capability
`rbac`	`string[]`	Access control capability
`sharedAccessKeys`	`string[]`	Shared access keys capability
`users`	`string[]`	Users capability
`views`	`string[]`	Views capability
`viewCapabilities`	`object`
`newTokenExpiresAt`	`string<date-time>`	Expiration date of the new token (ISO 8601 format)

Request

curl -X POST 'https://api.axiom.co/v2/tokens/ID/regenerate' \
  -H 'Authorization: Bearer API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"existingTokenExpiresAt":"2026-01-01T00:00:00Z","newToken":{"datasetCapabilities":{},"description":"string","expiresAt":"2026-01-01T00:00:00Z","name":"string","orgCapabilities":{"annotations":["create"],"apiTokens":["create"],"auditLog":["read"],"billing":["read"],"dashboards":["create"],"datasets":["create"],"endpoints":["create"],"integrations":["create"],"labels":["create"],"monitors":["create"],"notifiers":["create"],"rbac":["create"],"sharedAccessKeys":["read"],"users":["create"],"views":["create"]},"viewCapabilities":{}},"newTokenExpiresAt":"2026-01-01T00:00:00Z"}'

Try itRun this request against your Axiom organization

Credentials stay in this browser tab and are only sent to Axiom when you run the request.

API token Requiredid pathRequiredRequest body application/json

Response

200New API token, including its secret `token` value.

application/json

400Missing `existingTokenExpiresAt`, expiry set in both `newTokenExpiresAt` and `newToken.expiresAt`, or invalid capabilities in `newToken`.

404API token not found or expired.