OverviewAccess tokens

Reset access token

Reset an access token's secret key with an optional expiry time for the old key.

Path parameters

idstringRequired
The ID of the access token to update

Headers

AuthorizationstringRequired

Query parameters

expirylongOptional
An expiration time for the old token key, expressed as a Unix epoch time in milliseconds. By default, the token will expire immediately.

Response

Access token response
_idstring
The ID of the access token
ownerIdstring
The ID of the owner of the account for the access token
memberIdstring
The ID of the member who created the access token
creationDatelong
Timestamp of when the access token was created
lastModifiedlong
Timestamp of the last modification of the access token
_memberobject or null
Details on the member who created the access token
namestring or null

A human-friendly name for the access token

descriptionstring or null
A description for the access token
customRoleIdslist of strings or null
A list of custom role IDs to use as access limits for the access token
inlineRolelist of objects or null

An array of policy statements, with three attributes: effect, resources, actions. May be used in place of a role.

rolestring or null
Base role for the token
tokenstring or null
The token value. When creating or resetting, contains the entire token value. Otherwise, contains the last four characters.
serviceTokenboolean or null
Whether this is a service token or a personal token
defaultApiVersioninteger or null
The default API version for this token
lastUsedlong or null
Timestamp of when the access token was last used

Errors