Generate Personal Access Token

HTTP MethodURLRequires Auth

POST

/api/v1/users.generatePersonalAccessToken

  • Permission required: create-personal-access-tokens

Body Parameters

KeyExample ValueDescription

tokenName*

mypersonaltoken

The name of the token.

bypassTwoFactor

true or false

If 2FA requirement should be ignored when using this token. By default, the value is false.

Example Call

curl -H "X-Auth-Token: 9HqLlyZOugoStsXCUfD_0YdwnNnunAJF8V47U3QHXSq" \
     -H "X-User-Id: aobEdbYhXfu5hkeqG" \
     -H "Content-type:application/json" \
     http://localhost:3000/api/v1/users.generatePersonalAccessToken \
     -d '{ 
          "tokenName": "mypersonaltoken", 
          "bypassTwoFactor": true }'

Example Response

{
  "token": "2jdk99wuSjXPO201XlAks9sjDjAhSJmskAKW301mSuj9Sk"
  "success": true
}

Change Log

VersionDescription

3.1.0

Added bypassTwoFactor param

0.69.0

Added

Last updated

Rocket.Chat versions receive support for six months after release.