• Public
    Cloud
    Backup management / Reference / REST API

    Public

    Postman Collection
    OpenAPI
    PUT

    Activate the backup policy

    Activate the backup policy in the org

    Forge and OAuth2 apps cannot access this REST resource.

    Request

    Path parameters

    orgId

    string

    Required
    policyId

    string

    Required

    Header parameters

    X-Atl-Account-Id

    string

    Required

    Responses

    Policy activated

    application/json

    PublicApiBackupV2Response
    PUT/public/backup-management/v2/orgs/{orgId}/policies/{policyId}/activate
    1 2 3 curl --request PUT \ --url 'https://api.atlassian.com/public/backup-management/v2/orgs/{orgId}/policies/{policyId}/activate' \ --header 'Accept: application/json'
    200Response
    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 { "backups": [ { "backupId": "<string>", "name": "<string>", "cloudId": "<string>", "product": "JIRA", "status": "CREATED", "statusMessage": "<string>", "accountId": "<string>", "expiryTime": "<string>", "selections": [ "USERS" ], "backupSize": { "usersSize": 2154, "dataSize": 2154, "attachmentsSize": 2154, "totalBackupSizeInGB": 2154 }, "createdAt": "<string>", "lastUpdatedAt": "<string>", "storageId": "<string>", "encryptionType": "<string>" } ], "totalItems": 2154 }
    GET

    Get Backup policy by Id

    Get Backup policy by policy Id in an org

    Forge and OAuth2 apps cannot access this REST resource.

    Request

    Path parameters

    orgId

    string

    Required
    policyId

    string

    Required

    Query parameters

    storageDetails

    boolean

    backupDetails

    boolean

    Responses

    Backup policy retrieved

    application/json

    PublicApiGetBackupPolicyV2Response
    GET/public/backup-management/v2/orgs/{orgId}/policies/{policyId}
    1 2 3 curl --request GET \ --url 'https://api.atlassian.com/public/backup-management/v2/orgs/{orgId}/policies/{policyId}' \ --header 'Accept: application/json'
    200Response
    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 { "policyId": "<string>", "policyName": "<string>", "cloudInfo": { "cloudId": "<string>", "cloudUrl": "<string>", "cloudName": "<string>", "encryptionType": "CMK" }, "productType": "JIRA", "status": "ACTIVE", "includeAttachments": true, "includePersonalSpaces": true, "includeUsersAndGroups": true, "details": { "storageId": "<string>", "backupDetails": { "lastBackupTime": "<string>", "totalAvailableBackups": 2154 }, "scheduleDetails": { "interval": "ONCE", "startDate": "<string>", "scheduleSlot": "<string>" } }, "createdAt": "<string>", "createdBy": "<string>" }
    PUT

    Update Backup policy

    Update Backup policy for a site in an org

    Forge and OAuth2 apps cannot access this REST resource.

    Request

    Path parameters

    orgId

    string

    Required
    policyId

    string

    Required

    Header parameters

    X-Atl-Account-Id

    string

    Required

    Request bodyapplication/json

    storageId

    string

    includeAttachments

    boolean

    includePersonalSpaces

    boolean

    scheduleRequest

    ScheduleBackupPolicyRequest

    Responses

    Backup policy updated

    application/json

    PublicApiGetBackupPolicyV2Response
    PUT/public/backup-management/v2/orgs/{orgId}/policies/{policyId}
    1 2 3 4 5 6 7 8 9 10 11 12 13 curl --request PUT \ --url 'https://api.atlassian.com/public/backup-management/v2/orgs/{orgId}/policies/{policyId}' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --data '{ "storageId": "<string>", "includeAttachments": true, "includePersonalSpaces": true, "scheduleRequest": { "interval": "ONCE", "startDate": "<string>" } }'
    200Response
    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 { "policyId": "<string>", "policyName": "<string>", "cloudInfo": { "cloudId": "<string>", "cloudUrl": "<string>", "cloudName": "<string>", "encryptionType": "CMK" }, "productType": "JIRA", "status": "ACTIVE", "includeAttachments": true, "includePersonalSpaces": true, "includeUsersAndGroups": true, "details": { "storageId": "<string>", "backupDetails": { "lastBackupTime": "<string>", "totalAvailableBackups": 2154 }, "scheduleDetails": { "interval": "ONCE", "startDate": "<string>", "scheduleSlot": "<string>" } }, "createdAt": "<string>", "createdBy": "<string>" }
    GET

    Get storages for a Org

    Get all the storages in the organisation. Requires authentication and proper permissions.

    Forge and OAuth2 apps cannot access this REST resource.

    Request

    Path parameters

    orgId

    string

    Required

    Header parameters

    X-Atl-Account-Id

    string

    Required

    Responses

    Storage Details are retrieved

    */*

    PublicApiGetStoragesResponse
    GET/public/backup-management/v2/orgs/{orgId}/storages
    1 2 3 curl --request GET \ --url 'https://api.atlassian.com/public/backup-management/v2/orgs/{orgId}/storages' \ --header 'Accept: */*'
    POST

    Create Storage in a Org

    Creates a new storage for the specified organization. Requires authentication and proper permissions.

    Forge and OAuth2 apps cannot access this REST resource.

    Request

    Path parameters

    orgId

    string

    Required

    Header parameters

    X-Atl-Account-Id

    string

    Required

    Request bodyapplication/json

    storageName

    string

    Required
    storageRegion

    string

    Required
    storagePrefix

    string

    Required
    storageType

    string

    Required
    roleIdentifier

    string

    Required
    principalTag

    string

    Required
    cloudId

    string

    Required

    Responses

    Storage created successfully

    application/json

    CreateStorageResponse
    POST/public/backup-management/v2/orgs/{orgId}/storages
    1 2 3 4 5 6 7 8 9 10 11 12 13 curl --request POST \ --url 'https://api.atlassian.com/public/backup-management/v2/orgs/{orgId}/storages' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --data '{ "storageName": "<string>", "storageRegion": "<string>", "storagePrefix": "<string>", "storageType": "<string>", "roleIdentifier": "<string>", "principalTag": "<string>", "cloudId": "<string>" }'
    201Response
    1 2 3 { "storageId": "<string>" }
    POST

    Initiate Import

    Initiate import for the given orgId and cloudId. The import will be created in the background and the response will contain the importId.

    Forge and OAuth2 apps cannot access this REST resource.

    Request

    Path parameters

    orgId

    string

    Required

    Header parameters

    X-Atl-Account-Id

    string

    Required

    Request bodyapplication/json

    cloudId

    string

    Required
    product

    string

    Required
    backupId

    string

    Required

    Responses

    Successfully created import

    */*

    ApiErrorResponse
    POST/public/backup-management/v2/orgs/{orgId}/imports
    1 2 3 4 5 6 7 8 9 curl --request POST \ --url 'https://api.atlassian.com/public/backup-management/v2/orgs/{orgId}/imports' \ --header 'Accept: */*' \ --header 'Content-Type: application/json' \ --data '{ "cloudId": "<string>", "product": "JIRA", "backupId": "<string>" }'
    POST

    Start restore

    Start restore operation for a specified backup into another site

    Forge and OAuth2 apps cannot access this REST resource.

    Request

    Path parameters

    orgId

    string

    Required
    destCloudId

    string

    Required

    Request bodyapplication/json

    backupId

    string

    Required
    product

    string

    Required
    includeAttachments

    boolean

    Required
    includeUsersAndGroups

    boolean

    Responses

    Restore scheduled

    application/json

    CreateRestoreResponse
    POST/public/backup-management/v2/orgs/{orgId}/cloud/{destCloudId}/restores
    1 2 3 4 5 6 7 8 9 10 curl --request POST \ --url 'https://api.atlassian.com/public/backup-management/v2/orgs/{orgId}/cloud/{destCloudId}/restores' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --data '{ "backupId": "<string>", "product": "JIRA", "includeAttachments": true, "includeUsersAndGroups": true }'
    201Response
    1 2 3 4 5 6 7 { "restoreId": "<string>", "cloudId": "<string>", "product": "JIRA", "status": "READY", "createdAt": "<string>" }
    POST

    Revalidate and schedule restore

    Revalidates and schedule restore. Requires authentication and proper permissions.

    Forge and OAuth2 apps cannot access this REST resource.

    Request

    Path parameters

    orgId

    string

    Required
    cloudId

    string

    Required

    Request bodyapplication/json

    restoreId

    string

    Required
    consent

    array<Consent>

    Responses

    Restore revalidated and scheduled

    application/json

    CreateRestoreResponse
    POST/public/backup-management/v2/orgs/{orgId}/cloud/{cloudId}/restores/revalidate
    1 2 3 4 5 6 7 8 9 10 11 12 13 curl --request POST \ --url 'https://api.atlassian.com/public/backup-management/v2/orgs/{orgId}/cloud/{cloudId}/restores/revalidate' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --data '{ "restoreId": "<string>", "consent": [ { "name": "PREFLIGHT_CONFLICTING_SPACE_CHECK_CONSENT", "value": true } ] }'
    201Response
    1 2 3 4 5 6 7 { "restoreId": "<string>", "cloudId": "<string>", "product": "JIRA", "status": "READY", "createdAt": "<string>" }
    POST

    Create a Backup policy

    Create a Backup policy for a product in a site in an org

    Forge and OAuth2 apps cannot access this REST resource.

    Request

    Path parameters

    orgId

    string

    Required
    cloudId

    string

    Required

    Header parameters

    X-Atl-Account-Id

    string

    Required

    Request bodyapplication/json

    product

    string

    Required
    storageId

    string

    includeAttachments

    boolean

    Required
    includePersonalSpaces

    boolean

    scheduleRequest

    ScheduleBackupPolicyRequest

    policyName

    string

    Required

    Responses

    Backup policy created

    application/json

    CreateBackupPolicyResponse
    POST/public/backup-management/v2/orgs/{orgId}/cloud/{cloudId}/policies
    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 curl --request POST \ --url 'https://api.atlassian.com/public/backup-management/v2/orgs/{orgId}/cloud/{cloudId}/policies' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --data '{ "product": "JIRA", "storageId": "<string>", "includeAttachments": true, "includePersonalSpaces": true, "scheduleRequest": { "interval": "ONCE", "startDate": "<string>" }, "policyName": "<string>" }'
    201Response
    1 2 3 4 { "policyId": "<string>", "policyName": "<string>" }
    GET

    Get storage by storageId

    Get storage details for the given storage Id. Requires authentication and proper permissions.

    Forge and OAuth2 apps cannot access this REST resource.

    Request

    Path parameters

    orgId

    string

    Required
    storageId

    string

    Required

    Header parameters

    X-Atl-Account-Id

    string

    Required

    Responses

    Storage Details are retrieved

    */*

    GetStorageDetailsResponse
    GET/public/backup-management/v2/orgs/{orgId}/storages/{storageId}
    1 2 3 curl --request GET \ --url 'https://api.atlassian.com/public/backup-management/v2/orgs/{orgId}/storages/{storageId}' \ --header 'Accept: */*'
    GET

    Get supported regions for org

    Get all the supported regions for given orgId, cloud and product. Requires authentication and proper permissions.

    Forge and OAuth2 apps cannot access this REST resource.

    Request

    Path parameters

    orgId

    string

    Required

    Query parameters

    cloudId

    string

    product

    string

    Header parameters

    X-Atl-Account-Id

    string

    Required

    Responses

    Supported regions fetched successfully

    */*

    GetEligibleRegionsForOrgResponse
    GET/public/backup-management/v2/orgs/{orgId}/storages/regions
    1 2 3 curl --request GET \ --url 'https://api.atlassian.com/public/backup-management/v2/orgs/{orgId}/storages/regions' \ --header 'Accept: */*'
    GET

    Get all restores for a site

    Get all restores for a site. Requires authentication and proper permissions.

    Forge and OAuth2 apps cannot access this REST resource.

    Request

    Path parameters

    orgId

    string

    Required

    Query parameters

    cloudId

    string

    product

    string

    queryParamFilter

    QueryParamFilter

    Required

    Responses

    Restores fetched

    */*

    GetRestoresResponse
    GET/public/backup-management/v2/orgs/{orgId}/restores
    1 2 3 curl --request GET \ --url 'https://api.atlassian.com/public/backup-management/v2/orgs/{orgId}/restores?queryParamFilter={queryParamFilter}' \ --header 'Accept: */*'
    GET

    Get restore status by restoreId

    Get restore status by restoreId. Requires authentication and proper permissions.

    Forge and OAuth2 apps cannot access this REST resource.

    Request

    Path parameters

    orgId

    string

    Required
    restoreId

    string

    Required

    Responses

    Restore status fetched

    */*

    Restore
    GET/public/backup-management/v2/orgs/{orgId}/restores/{restoreId}
    1 2 3 curl --request GET \ --url 'https://api.atlassian.com/public/backup-management/v2/orgs/{orgId}/restores/{restoreId}' \ --header 'Accept: */*'
    GET

    Get all Backup policies

    Get all Backup policies for an org

    Forge and OAuth2 apps cannot access this REST resource.

    Request

    Path parameters

    orgId

    string

    Required

    Query parameters

    cloudId

    string

    product

    string

    queryParamFilterForV2BackupPolicy

    QueryParamFilterForV2BackupPolicy

    Required

    Responses

    Backup policies retrieved

    application/json

    PublicApiAllPoliciesResponse
    GET/public/backup-management/v2/orgs/{orgId}/policies
    1 2 3 curl --request GET \ --url 'https://api.atlassian.com/public/backup-management/v2/orgs/{orgId}/policies?queryParamFilterForV2BackupPolicy={queryParamFilterForV2BackupPolicy}' \ --header 'Accept: application/json'
    200Response
    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 { "policies": [ { "policyId": "<string>", "policyName": "<string>", "cloudInfo": { "cloudId": "<string>", "cloudUrl": "<string>", "cloudName": "<string>", "encryptionType": "CMK" }, "productType": "JIRA", "status": "ACTIVE", "includeAttachments": true, "includePersonalSpaces": true, "includeUsersAndGroups": true, "details": { "storageId": "<string>", "backupDetails": { "lastBackupTime": "<string>", "totalAvailableBackups": 2154 }, "scheduleDetails": { "interval": "ONCE", "startDate": "<string>", "scheduleSlot": "<string>" } }, "createdAt": "<string>", "createdBy": "<string>" } ], "totalItems": 2154 }
    GET

    Get all Backups for a policy

    Get all Backups for a policy by policy id in an org

    Forge and OAuth2 apps cannot access this REST resource.

    Request

    Path parameters

    orgId

    string

    Required
    policyId

    string

    Required

    Query parameters

    queryParamFilter

    QueryParamFilter

    Required

    Responses

    Backups retrieved

    application/json

    PublicApiBackupV2Response
    GET/public/backup-management/v2/orgs/{orgId}/policies/{policyId}/backups
    1 2 3 curl --request GET \ --url 'https://api.atlassian.com/public/backup-management/v2/orgs/{orgId}/policies/{policyId}/backups?queryParamFilter={queryParamFilter}' \ --header 'Accept: application/json'
    200Response
    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 { "backups": [ { "backupId": "<string>", "name": "<string>", "cloudId": "<string>", "product": "JIRA", "status": "CREATED", "statusMessage": "<string>", "accountId": "<string>", "expiryTime": "<string>", "selections": [ "USERS" ], "backupSize": { "usersSize": 2154, "dataSize": 2154, "attachmentsSize": 2154, "totalBackupSizeInGB": 2154 }, "createdAt": "<string>", "lastUpdatedAt": "<string>", "storageId": "<string>", "encryptionType": "<string>" } ], "totalItems": 2154 }
    GET

    Get import details for specified importId and cloudId

    Get import details for specified importId and cloudId

    Forge and OAuth2 apps cannot access this REST resource.

    Request

    Path parameters

    orgId

    string

    Required
    cloudId

    string

    Required
    importId

    string

    Required

    Header parameters

    X-Atl-Account-Id

    string

    Required

    Responses

    Retrieved import details

    application/json

    GetIxportDetailsResponse
    GET/public/backup-management/v2/orgs/{orgId}/cloud/{cloudId}/imports/{importId}
    1 2 3 curl --request GET \ --url 'https://api.atlassian.com/public/backup-management/v2/orgs/{orgId}/cloud/{cloudId}/imports/{importId}' \ --header 'Accept: application/json'
    200Response
    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 { "id": "<string>", "name": "<string>", "createdAt": "<string>", "lastUpdatedAt": "<string>", "status": "CREATED", "source": { "locationType": "CLOUD_URL", "cloudInfo": { "cloudId": "<string>", "cloudUrl": "<string>", "cloudName": "<string>", "encryptionType": "CMK" } }, "productType": "JIRA", "accountId": "<string>", "expiryTime": "<string>", "selections": [ "USERS" ], "backupSize": { "usersSize": 2154, "dataSize": 2154, "attachmentsSize": 2154, "totalBackupSizeInGB": 2154 } }

    Rate this page: