This is an archive version of the document. To get the most up-to-date information, see the current version.

Getting Authorization Tokens

VAO RESTful API authorization with Swagger UI involves the following procedures:

Obtain a pair of tokens:

On the Veeam Availability Orchestrator RESTAPI page, expand the Accounts resource and click POST /v1/Accounts/Token.
From the grant_type drop-down list, select password (default).
In the username and password fields, specify the credentials of a user with the Site Administrator or Failover Plan Author privileges.
Click Try it out.

Wait for the response from the server. A successfully completed operation returns the 200 Success response code, and an access and refresh tokens in the response body.

Save the refresh token locally for further use.
Make sure that the access key is automatically inserted in the api_key field at the top of the page.
At the top of the page, in the api_key field, click Explore.

When the access token expires, use the refresh token:

On the Veeam Availability Orchestrator RESTAPI page, expand the Accounts resource and click POST /v1/Accounts/Token.
From the grant_type drop-down list, select refresh_token.
In the refresh_token field, insert the refresh token saved locally.
Click Try it out.

Wait for the response from the server. A successfully completed operation returns the 200 Success response code and a new pair of tokens in the response body.

When you finish working with VAO RESTful API:

On the Veeam Availability Orchestrator RESTAPI page, expand the Accounts resource and click GET /v1/Accounts/Logout.
Click Try it out.

Wait for the response from the server. A successfully completed operation returns the 200 Success response code and the "Logout successful" message in the response body.