Authentication

Requests to an Acronis API endpoint must follow Bearer Authentication scheme, unless otherwise stated. This scheme requires specifying a token in the Authorization header of a request. A token is a unique cryptic string generated by the cloud platform. Tokens eliminate the need for passing user credentials with requests.

The token is issued by the /idp/token endpoint of the Acronis Account Management API v2.

To generate a token, see Authenticating to the Acronis platform.

Example

A request made via cURL for an API has the following form:

curl -X POST -s <the Acronis data center URL>/<Acronis API location>/<endpoint> \
    --header "Authorization: Bearer 8770b34b74f9e4d9424eff50c38182bb4ae7f5596582ae61900b1b6a23e3ec58"

If, for example, the token specified in the Authorization header is expired or your account is disabled, the API will respond with a 401 status code.

Important

For security reasons, the token expiration time is set to two hours. After this time, the API will respond with a 401 status code.

In this section

• Authenticating to the Acronis platform