Sign in
Deployment Tokens

Rotate a deployment token, invalidating its old secret and issuing a new one

post/projects/{project_id}/deployment-tokens/{token_id}/rotate

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/projects/{project_id}/deployment-tokens/{token_id}/rotate
  • Auth: HTTP bearer

Path parameters

project_idinteger required

Project ID

token_idinteger required

Deployment token ID

Response

Deployment token rotated successfully; the response contains the new plaintext token, shown only once

created_atstring date-time required
deployment_idinteger nullable
environment_idinteger nullable
expires_atstring date-time nullable
idinteger required
namestring required
permissionsstring[] nullable
project_idinteger required
tokenstring required

The full token value - only returned on creation

token_prefixstring required

Example response

{
  "created_at": "2024-01-01T00:00:00Z",
  "expires_at": "2024-12-31T23:59:59Z"
}

Changes

No recorded changes to this operation across all 50 revisions of this API.