Skip to content

Stable API tag

tokens

API token lifecycle

3 paths · 4 operations

/v1/tokens

get

List API tokens visible to the caller

Operation ID
listTokens
Authentication
Bearer token
Request body
None
Parameters
NameInRequiredType
limitquerynointeger
cursorquerynostring
include_revokedquerynoboolean

Response codes

200 · 400 · 401 · 403 · 404 · 409 · 429

post

Issue an API token

Operation ID
issueToken
Authentication
Bearer token
Request body
Present · required

Parameters: none declared.

Response codes

201 · 400 · 401 · 403 · 404 · 409 · 429

/v1/tokens/{id}

delete

Revoke an API token

Operation ID
revokeToken
Authentication
Bearer token
Request body
None
Parameters
NameInRequiredType
idpathyesstring · uuid

Response codes

204 · 400 · 401 · 403 · 404 · 409 · 429

/v1/tokens/{id}/rotate

post

Rotate an API token (issue new secret, revoke old)

Operation ID
rotateToken
Authentication
Bearer token
Request body
None
Parameters
NameInRequiredType
idpathyesstring · uuid

Response codes

200 · 400 · 401 · 403 · 404 · 409 · 429