Regenerate Personal Access Token
- Print
- DarkLight
- PDF
Regenerate Personal Access Token
- Print
- DarkLight
- PDF
Article summary
Did you find this summary helpful?
Thank you for your feedback
Post
/api/v1/users.regeneratePersonalAccessToken
Permission required: create-personal-access-tokens. This endpoint requires 2FA.
Changelog
| Version | Description |
|---|---|
| 0.69.0 | Added |
Header parameters
X-Auth-Token
stringRequired
The authenticated user token.
ExampleRScctEHSmLGZGywfIhWyRpyofhKOiMoUIpimhvheU3f
X-User-Id
stringRequired
The authenticated user ID.
ExamplerbAXPnMktTFbNpwtJ
Example148750
x-2fa-method
stringRequired
The desired method to get the 2FA code. It can be email, totp, or password.
Body parameters
Example 1
{
"tokenName": "mypersonaltoken"
}object
tokenName
string Required
The name of the token.
Responses
200
OK
Success Example
{
"token": "2jdk99wuSjXPO201XlAks9sjDjAhSJmskAKW301mSuj9Sk",
"success": true
}object
token
string
success
boolean
400
Bad Request
Example 1
{
"success": false,
"error": "TOTP Required [totp-required]",
"errorType": "totp-required",
"details": {
"method": "password",
"codeGenerated": false,
"availableMethods": []
}
}Example 2
{
"success": false,
"error": "The 'tokenName' param is required"
}Example 3
{
"success": false,
"error": "Not Authorized [not-authorized]",
"errorType": "not-authorized",
"details": {
"method": "personalAccessTokens:generateToken"
}
}object
success
boolean
error
string
errorType
string
details
object
method
string
codeGenerated
boolean
availableMethods
Array of object
object
401
Unauthorized
Authorization Error
{
"status": "error",
"message": "You must be logged in to do this."
}object
status
string
message
string
Was this article helpful?