---
title: "createExport"
method: POST
path: "/v2/recovery/export"
tags: ["Restore & Download"]
---

# createExport

`POST /v2/recovery/export`

Download a backup.

## Request body

- ExportDTO — Download settings
  - `taskId` string, required — Backup task ID
  - `account` string, required — Account to restore
  - `source` 'GMAIL' | 'GDOC' | 'GDRIVETEAM' | 'SFC' | 'GOOGLEAPPS' | 'GCALENDAR' | 'GTASK' | 'GCONTACTS' | 'YMAIL' | 'GACCOUNTS' | 'GSITES' | 'SDB' | 'O365MAIL' | 'O365CONTACTS' | 'DDB' | 'MS365' | 'O365CALENDAR' | 'O365TASKS' | 'SHAREPOINT' | 'SHAREPOINT_MULTI' | 'ONEDRIVE' | 'IMAP' | 'BOX' | 'PUBLICWORDPRESS' | 'DROPBOX' | 'MS365GROUPS' | 'MS365GROUP_CONVERSATIONS' | 'MS365GROUP_CALENDAR' | 'MS365GROUP_SITE' | 'MS365GROUP_META' | 'O365NOTES' | 'MS365TEAM_CHANNELS' | 'MS365TEAM_APPS' | 'MSTEAMS' | 'MSGROUPS' | 'INTERNAL' | 'DYNAMICS365' | 'ENTRAID', required — Service to restore
  - `date` integer, required — Backup date
  - `includeDeleted` boolean — Include deleted items
  - `includeLegalHold` boolean — Include files with the legal hold
  - `extid` string — External id of entity (for multiple entities tasks)
  - `entities` TaskEntityDTO[] — for item level recovery
    - `entityId` string — Backup entity ID
    - `filename` string — File name
    - `backupDate` integer — Backup date
    - `folderid` string — Folder ID
    - `parentId` string — Parent ID
    - `isDeleted` string — is deleted
    - `entityType` 'FOLDER' | 'DOCUMENT' | 'QUERY' | 'MD_FOLDER' | 'MD_FILE' | 'SEMI_FOLDER' — Entity type
    - `itemId` integer — Item ID
  - `downloadToPst` boolean — Download in PST format (splits large files into chunks)
  - `preferSinglePST` boolean — Download in PST format (single file)
  - `storageType` 'CLOUDALLY_S3' | 'AMAZON_S3' | 'AZURE' | 'GOOGLE_CLOUD_PLATFORM' | 'AMAZON_S3_COMPATIBLE' — Optional, default value is CLOUDALLY_S3, use this field if you wish to download data to your own cloud storage
  - `storageBucketName` string — AWS/GCP bucket name or Azure blob container name, used with AMAZON_S3, AMAZON_S3_COMPATIBLE, GOOGLE_CLOUD_PLATFORM or AZURE storage type
  - `storageKey` string — AWS/GCP Key or Azure account name, used with AMAZON_S3, AMAZON_S3_COMPATIBLE, GOOGLE_CLOUD_PLATFORM or AZURE storage type
  - `storageSecretKey` string — AWS/GCP secret key or Azure access key, used with AMAZON_S3, AMAZON_S3_COMPATIBLE, GOOGLE_CLOUD_PLATFORM or AZURE storage type
  - `storageRegion` 'US_EST' | 'US_EST_OHIO' | 'US_WEST_OREGON' | 'US_WEST_CAL' | 'EU' | 'EU_FRANKFURT' | 'ASIA_HONG_KONG' | 'ASIA_MUMBAI' | 'ASIA_SEOUL' | 'ASIA_SINGAPORE' | 'ASIA_SIDNEY' | 'ASIA_TOKYO' | 'SOUTH_AMERICA' | 'AFRICA_CAPE_TOWN' | 'ASIA_CHINA' | 'CANADA' | 'LONDON' | 'EU_PARIS' | 'EU_STOCKHOLM' | 'EU_ZURICH' — AWS/GCP storage Region, used with AMAZON_S3, AMAZON_S3_COMPATILE or GOOGLE_CLOUD_PLATFORM storage type
  - `storageEndPoint` string — Storage endpoint URL, used with AMAZON_S3_COMPATIBLE

## Response `200`

Successful retrieval of the information.

## Other responses

- `401` — The user is not logged in.
- `403` — The user does not have an access to view the account activity.

---

[API](https://skmtc.dev/cloudally/apis/cloudally-rest-api.md) · [All operations](https://skmtc.dev/cloudally/apis/cloudally-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cloudally/cloudally-rest-api/revisions/97e3a3740b5b/schema)
