Page optimized for desktop experience. Please use a desktop browser for best compatibility.

Rev User-Level API Key Authentication

This authentication API endpoint is used to authenticate individual user using user’s pre-generated API Key and Secret. Use the token that is returned in the response as the Authorization to run other public APIs. Once a session is established using this endpoint, subsequent API calls that uses the token returned from this endpoint will be limited according to the role and privileges of this particular user. Using this method, the user via API will have the same privileges and roles that user has when they login to Rev UI. This authentication mechanism can be used to automate Rev workflows using role and privileges of a given user.

Account Admins can generate user’s API Key and Secret combination. Secret is only visible at the time of generation. API Key and Secret combination can be regenerated and deleted. The key will not work for suspended users. Also authenticating a user using this method will consume a user license if the user is unlicensed.

 

POST
/api/v2/authenticate

Request Body

application/json

{"ApiKey":"3432lkjdfasdf7897asdfmyapikeyhere","Secret":"asfasdfe8342242342mysecrethere"}

Response Messages

Successful response

"token": "0SoxSd50t5V-Or6MpWMGa6Al8dKzCRhyqKCxi7PsDJwmbN4-PQb86IXTtS-zQc5s6Mx3Orz5eGdtQqn1r7cTuakEBGsnI_ETHmjDPYk2fkbPVhYcs5OzTEMhhR_3vnlHgyht_Af-fEBnQ4XBgLhFtbBIfgRrI_BemY-vRKG9Qyqn6Iwake74PwxBsGGETd77FNmmos86vTO8V35HuUTYVAiCCGPLDKS966gZhDsQqIY1", "issuer": "VBrick", "expiration": "2020-07-14T20:34:13.881Z"

Unauthorized error

Internal server error