Versioning

Veeam Backup & Replication REST API is backward-compatible. This means that, in general, client requests that use an earlier version or revision of the REST API are compatible with further REST API updates. You can find the current Veeam Backup & Replication REST API version and revision in the REST API specification. It is specified in the version field of the info object. For example:

"version": "1.1-rev1"

REST API Revisions

The table below lists the REST API revisions, their support statuses, and the Veeam Backup & Replication build numbers when the REST API revisions were released.

The Deprecated support status is intermediate. Deprecated REST API revisions are expected to become unsupported. You can still use them but it is recommended that you switch to a newer one.

REST API Revision

Support Status

Veeam Backup & Replication Build

1.1-rev1

Supported

12.1.0.2131

1.1-rev0

Supported

12.0.0.1420

1.0-rev2

Deprecated

11.0.1.1261

1.0-rev1

Deprecated

11.0.0.837

Working with REST API Revisions

You must specify the Veeam Backup & Replication REST API version and revision in each request. The requirement lets you minimize changes in your client application with every REST API update.

Veeam Backup & Replication REST API implements a combined approach of versioning:

  • Major version is specified in the request path in the following format: v<major_version>.

The current major version is v1.

  • Version and revision are specified in the request header in the following format: <version>-<revision>.

The current version and revision is 1.1-rev1.

For example, to obtain current date and time on the backup server, send the HTTP GET request to the api/<major_version>/serverTime path. In the x-api-version header, specify a version and revision in the following format: <version>-<revision>.

Request

GET https://enterprise01.tech.local:9419/api/v1/serverTime

 

Request Header

x-api-version:1.1-rev1