Skip to main content
PUT
Update Access Token

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

access_token_id
string<uuid>
required

The token's id.

Example:

"546c65d6-e589-4d3c-b1fe-7e61711cc418"

Body

application/json

A field that is left out keeps its value. A request that sets no field changes nothing.

expires_at
string

When the token should expire, as an RFC 3339 timestamp or a YYYY-MM-DD date. A date is read as midnight UTC.

The expiry must be at least 24 hours and at most 365 days from now.

Example:

"2027-10-31T11:19:13.400498Z"

name
string

The token's new name.

Required string length: 1 - 256
permissions
object[]

The permissions to grant, replacing the current set. admin access can't be granted.

Response

UpdateAccessToken 200 response

Everything about a System Access Token except its credential.

expires_at
string<date-time>
required

When the token expires.

id
string<uuid>
required

The token's id.

Example:

"546c65d6-e589-4d3c-b1fe-7e61711cc418"

name
string
required

The token's name.

permissions
object[]
required

The permissions granted to the token.