Versioning, pagination, and data retention

Versioning

The current version of the backup management APIs is v2. The v1 APIs will be deprecated.

Pagination

We've implemented pagination in the following backup management APIs:

• Get all backup policies

• Get all backups

• Get all restores

How does pagination work?

In the GET APIs listed above, you need to provide certain request parameters to define the page that to be returned as a response. These are:

• start - Defines the start page of the response. Note that this can't be a negative value.

• pageSize - Defines the number of entries per page.

• sortOrder - Defines the order in which the content in the response is returned. The default value is DESC (descending), but you can also specify ASC (ascending).

• sortBy - Returns results sorted by creation timestamp.

Data retention

The data retention period for all product data backed up and stored in Atlassian-owned S3 is 30 days.

You can retrieve the backed up data by initiating a restore using the Create restore API.