Replace a token with a twin
post/account/tokens/{id}/rotate
Replace a token with a twin; the old one keeps working for the overlap. The new secret is shown once.
Before you call
- Credential
Authorization: Bearer $KEY- Scope
workspace:write- Sdk
workspace.accountToken.rotate- Cli
workspace account token rotate
Parameters
- idstring (uuid)requiredIn the path
Request bodyapplication/json, required
- overlapHoursnumberAt least 0. At most 720.
Responses
- 201application/jsonSuccess
object - 400application/jsonThe request was malformed
- errorstringrequired
- messagestring
- 401application/jsonNo valid credential
- errorstringrequired
- messagestring
- 403application/jsonThe credential lacks the scope, origin or address
- errorstringrequired
- messagestring
- 429application/jsonOver the key's rate limit; see Retry-After
- errorstringrequired
- messagestring