Exporting your data: questions and answers
Short answers about the organization export: what is in it, who can make one, the archive and its manifest, downloading and how long it is kept. Each answer links to the section of Export that owns the rule.
The basics
- What is an export?
- What is an export for?
- Does exporting change or lock anything?
- Who can export an organization?
- Can a member start an export?
- Can the admin of a single workspace start an export?
- Do I need a verified email address to export?
- Can I download an export that another admin started?
- Can I export a single workspace or folder?
- How do I start an export?
- How long does an export take?
- Do I have to keep the page open while the export is built?
- Can I cancel an export?
- Can two people export at the same time?
- What happens if I choose "Start export" twice?
- How many exports can an organization make?
- Can I export a deleted organization?
- Can exports run automatically on a schedule?
- Does starting a new export remove the earlier ones?
- Why is "Start export" disabled?
- Where is the "Export" section?
- What happens if I choose "Start export" while an export is ready?
What an export contains
- What is in an export?
- What is not in an export?
- Does an export include older versions of a file?
- Does an export include the trash?
- Does an export include deleted workspaces?
- Does an export include the organization folder?
- Does an export include the member list, roles or invitations?
- Does an export include API keys or connected apps?
- Does an export include public links and sharing settings?
- Does an export include the audit trail?
- Does an export include thumbnails and previews?
- Does an export keep my folders and tags?
- Does an export include file statuses and custom fields?
- Does an export include alt text, descriptions and captions?
- Does an export include favorites or organization folder suggestions?
- Are uploads that are still in progress exported?
- Is a file that is uploaded during the export included?
- Which version is exported when a file gets a new version during the export?
- What does an export of an organization without files contain?
- Are the exported files checked for damage?
- Does the export say who uploaded each file?
- Does the export contain workspaces I am not a member of?
- What happens to a workspace that is deleted while the export is pending?
- Is a trashed folder listed in the manifest?
The archive
- What format is an export?
- How is the archive organized?
- Why are the files in the zip named by ID and not by name?
- Where do I find a file's real name in an export?
- Which extension do files get in the archive?
- Is the archive compressed?
- Which dates do the entries of the archive carry?
- What happens to two files with the same name in one folder?
- How big is my export?
The manifest
- What is
manifest.json? - What do
formatandversionsay in the manifest? - How do I rebuild my folder structure from an export?
- How do I check that an exported file arrived intact?
- What does
currentVersionhold? - What does
parentVersionIDtell me? - How are tags written in the manifest?
- How is a file's status written in the manifest?
- How are custom field values written in the manifest?
- What does a file without status, tags or field values look like in the manifest?
- In what order are workspaces and files listed in the manifest?
- Does the manifest list tags that no file uses?
- What is
requestedAtin the manifest? - Which kinds of fields can
fileFieldshold? - How do I read the manifest without unpacking the whole archive?
- What does a
digestlook like? - How does the manifest describe the organization folder?
- How do I know which folder a file was in?
States and the email
- Which states can an export have?
- How do I know my export is ready?
- Why did my export fail?
- The export failed. What do I do?
- Am I emailed when an export fails?
- What does "This export has expired. Start a new one." mean?
- What does "This export is not available. Start a new one." mean?
- What does "Could not check the export. Reload the page to try again." mean?
- What happens to an export that stays pending for a long time?
- Who gets the "export ready" email?
- What does the export email say?
- Does the button in the export email download the archive directly?
- I started the export but my colleague did not get an email. Why?
- Why did I not get the "export ready" email?
- A second admin chose "Start export" while mine was pending. Who gets the email?
- What happens if the person who started the export is removed before it is ready?
- I opened the link from the export email and got "Not found". Why?
- Can an export go back from failed or expired to ready?
Downloading and keeping
- How do I download an export?
- How long can I download an export?
- How long does a download link work?
- The download link stopped working. Why?
- Can I download the same export more than once?
- Is the download link safe to share?
- Does downloading the archive need a sign-in?
- The export expired. Can I get it back?
- What happens to the archive when its 7 days are over?
- Can I delete an export before it expires?
- Where is the list of earlier exports?
- How do I find an export again?
- Why does the page show only "Start export" although I exported before?
- Can I bookmark an export?
- What does "Could not start the download. Try again." mean?
- The page shows "Export ready" but no download starts. Why?
- What happens to a ready export when the organization is deleted?
- What happens to a pending export when the organization is deleted?
- What happens to exports when the organization is removed for good?
- Should I export before deleting an organization?
- Can I import an export into another organization?
- A download link was requested seconds before the export expired. How long does it work?
- From when are the 7 days of an export counted?
The API and agents
- Can an agent start an export?
- Which API operations exist for exports?
- What does the API answer when an export is started?
- How do I wait for an export through the API?
- What does an export look like in the API?
- Can I hand the download link to a script?
- Should the download request carry cookies or an
Authorizationheader? - What can an agent do in place of an export?
- Why does starting an export answer
409 CONFLICT? - What does
404 NOT_FOUNDmean for an export? - Is a failed export an error answer in the API?
- Is exporting recorded in the audit trail?
- When is
downloadURLset on an export?