# 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](../organizations/export.md)
that owns the rule.

## The basics

### What is an export?

A copy of an organization's files that you can download and keep. It is one
zip archive with the current version of every live file in every workspace
and in the organization folder, and a file `manifest.json` that describes them.

More: [Export, Summary](../organizations/export.md#summary)

### What is an export for?

To take your content with you or to keep an offline copy.

More: [Export, Summary](../organizations/export.md#summary)

### Does exporting change or lock anything?

No. An export does not change anything in the organization. People keep
working while it is built.

More: [Export, Summary](../organizations/export.md#summary)

### Who can export an organization?

Owners and admins of the organization.

More: [Export, Who can do what](../organizations/export.md#who-can-do-what)

### Can a member start an export?

No. A member who starts or reads an export gets `403 FORBIDDEN`. Members do
not see the "Export" section.

More: [Export, Who can do what](../organizations/export.md#who-can-do-what)

### Can the admin of a single workspace start an export?

No. The organization role is what counts. Being owner or admin of one
workspace is not enough.

More: [Export, Who can do what](../organizations/export.md#who-can-do-what)

### Do I need a verified email address to export?

No. A verified email is not needed.

More: [Export, Who can do what](../organizations/export.md#who-can-do-what)

### Can I download an export that another admin started?

Yes. Any owner or admin can read and download any export of the
organization, not only the one they started. You need its ID or the page's
address, because there is no list of exports.

More: [Export, Who can do what](../organizations/export.md#who-can-do-what)

### Can I export a single workspace or folder?

No. An export always covers the whole organization. To download one folder
or a selection of files, use a ZIP download in Files & Assets.

More: [Export, Starting](../organizations/export.md#starting)

### How do I start an export?

On **Settings > Organization > General**, in the section "Export", choose
"Start export". The section then shows "Preparing the export. We will email
you when it is ready."

More: [Export, In the app](../organizations/export.md#in-the-app)

### How long does an export take?

It depends on how much there is to copy. It is built in the background and
can take a while for a large organization. You get an email when it is
ready.

More: [Export, Starting](../organizations/export.md#starting)

### Do I have to keep the page open while the export is built?

No. You can leave the page. The status updates by itself while you stay,
and the person who started the export is emailed when it is ready.

More: [Export, In the app](../organizations/export.md#in-the-app)

### Can I cancel an export?

No. An export cannot be cancelled.

More: [Export, Starting](../organizations/export.md#starting)

### Can two people export at the same time?

An organization builds one export at a time. The second person gets the
export that is already being built.

More: [Export, Starting](../organizations/export.md#starting)

### What happens if I choose "Start export" twice?

One export is built. Starting again while one is pending does not start a
second one. It returns the pending export.

More: [Export, Starting](../organizations/export.md#starting)

### How many exports can an organization make?

There is no limit on how many exports an organization makes over time. Only
one is built at a time.

More: [Export, Limits](../organizations/export.md#limits)

### Can I export a deleted organization?

No. An export of a deleted organization cannot be started. Export before
deleting, or restore the organization first.

More: [Export, Starting](../organizations/export.md#starting)

### Can exports run automatically on a schedule?

No. An export starts when an owner or admin chooses "Start export" in a
browser. Nothing starts one by itself.

More: [Export, Starting](../organizations/export.md#starting)

### Does starting a new export remove the earlier ones?

No. Earlier ready exports stay downloadable until they expire, so several
archives can exist side by side.

More: [Export, Starting](../organizations/export.md#starting)

### Why is "Start export" disabled?

An export is pending. While one is being built, "Start export" is disabled.

More: [Export, In the app](../organizations/export.md#in-the-app)

### Where is the "Export" section?

On **Settings > Organization > General**, for owners and admins. It says
"Download every file as its current version, with a JSON manifest of
folders, tags, statuses and fields. Archives are kept for 7 days."

More: [Export, In the app](../organizations/export.md#in-the-app)

### What happens if I choose "Start export" while an export is ready?

A new export starts, and the section then shows the new one. The earlier
archive stays downloadable until it expires.

More: [Export, In the app](../organizations/export.md#in-the-app)

## What an export contains

### What is in an export?

The current version of every live file in every live workspace and in the
organization folder, plus `manifest.json` with names, folders, tags, statuses,
fields and version details.

More: [Export, What the archive holds](../organizations/export.md#what-the-archive-holds)

### What is not in an export?

Trashed files and folders, deleted workspaces, earlier versions, previews
and other derived images or video renditions, unfinished uploads, members,
roles, invitations, API keys, connected apps, public links and sharing
settings, favorites, organization folder suggestions and the audit trail.

More: [Export, What the archive holds](../organizations/export.md#what-the-archive-holds)

### Does an export include older versions of a file?

No, only the current version's content. The manifest gives its version
number, and `parentVersionID` shows that earlier versions exist.

More: [Export, What the archive holds](../organizations/export.md#what-the-archive-holds)

### Does an export include the trash?

No. Files and folders in the trash are left out.

More: [Export, What the archive holds](../organizations/export.md#what-the-archive-holds)

### Does an export include deleted workspaces?

No. Deleted workspaces are left out, with everything in them. Restore a
workspace before exporting if you want its files in the archive.

More: [Export, What the archive holds](../organizations/export.md#what-the-archive-holds)

### Does an export include the organization folder?

Yes. Every live file in the organization folder is in the archive, as its
current version.

More: [Export, What the archive holds](../organizations/export.md#what-the-archive-holds)

### Does an export include the member list, roles or invitations?

No. Members, roles and invitations are left out.

More: [Export, What the archive holds](../organizations/export.md#what-the-archive-holds)

### Does an export include API keys or connected apps?

No. Credentials are never exported.

More: [Export, What the archive holds](../organizations/export.md#what-the-archive-holds)

### Does an export include public links and sharing settings?

No. The archive does not say which files are public.

More: [Export, What the archive holds](../organizations/export.md#what-the-archive-holds)

### Does an export include the audit trail?

No. The audit trail is not in the archive.

More: [Export, What the archive holds](../organizations/export.md#what-the-archive-holds)

### Does an export include thumbnails and previews?

No. Previews and other derived images or video renditions are left out.
The archive holds the files themselves.

More: [Export, What the archive holds](../organizations/export.md#what-the-archive-holds)

### Does an export keep my folders and tags?

Yes, in `manifest.json`. Each workspace and the organization folder have
`folders` and `tags`, and each file names its `folderID` and `tagIDs`. The
archive itself is not laid out in your folders.

More: [Export, The manifest](../organizations/export.md#the-manifest)

### Does an export include file statuses and custom fields?

Yes. Each workspace and the organization folder have their own statuses and
fields, so the manifest lists `statuses` and `fileFields` under each
workspace and under `library`, and each file carries its `statusID` and its
`fields` values.

More: [Export, The manifest](../organizations/export.md#the-manifest)

### Does an export include alt text, descriptions and captions?

Yes. Each file in the manifest has `altText`, `description` and `caption`,
or `null` where it has none.

More: [Export, The manifest](../organizations/export.md#the-manifest)

### Does an export include favorites or organization folder suggestions?

No. Both are left out.

More: [Export, What the archive holds](../organizations/export.md#what-the-archive-holds)

### Are uploads that are still in progress exported?

No. Uploads that are not finished are left out.

More: [Export, What the archive holds](../organizations/export.md#what-the-archive-holds)

### Is a file that is uploaded during the export included?

It is in the archive completely, or not in it at all. Everything is read at
one moment.

More: [Export, What the archive holds](../organizations/export.md#what-the-archive-holds)

### Which version is exported when a file gets a new version during the export?

The version that was current at the moment the export read the
organization.

More: [Export, What the archive holds](../organizations/export.md#what-the-archive-holds)

### What does an export of an organization without files contain?

Only `manifest.json`. The export still becomes ready: an empty organization
is a valid export.

More: [Export, Edge cases](../organizations/export.md#edge-cases)

### Are the exported files checked for damage?

Yes. While the archive is built, each file's stored content is checked
against its recorded digest. If a file fails that check, the export fails
instead of handing out a damaged copy.

More: [Export, What the archive holds](../organizations/export.md#what-the-archive-holds)

### Does the export say who uploaded each file?

It names who made each file's current version, in `createdBy` of
`currentVersion`, with their ID and full name. For someone who
deleted their account the name reads "Deleted user".

More: [Export, The manifest](../organizations/export.md#the-manifest)

### Does the export contain workspaces I am not a member of?

Yes. An export covers every live workspace of the organization. Only owners
and admins can export, and they reach every workspace anyway.

More: [Export, What the archive holds](../organizations/export.md#what-the-archive-holds)

### What happens to a workspace that is deleted while the export is pending?

The archive holds whatever was live at the moment the export read the
organization.

More: [Export, What the archive holds](../organizations/export.md#what-the-archive-holds)

### Is a trashed folder listed in the manifest?

No. It is not in the manifest's `folders`, and its files are not in
`assets`.

More: [Export, Edge cases](../organizations/export.md#edge-cases)

## The archive

### What format is an export?

One zip file. Its download name is `export-<exportID>.zip`.

More: [Export, The layout of the archive](../organizations/export.md#the-layout-of-the-archive)

### How is the archive organized?

The first entry is `manifest.json`. Each workspace file is at
`workspaces/<workspaceID>/assets/<fileID>/current.<extension>`, and each
organization folder file at `library/assets/<fileID>/current.<extension>`.

More: [Export, The layout of the archive](../organizations/export.md#the-layout-of-the-archive)

### Why are the files in the zip named by ID and not by name?

So that two files with the same name never clash and no name can be invalid
in an archive. `manifest.json` gives each file's name, folder and its path
in the zip.

More: [Export, The layout of the archive](../organizations/export.md#the-layout-of-the-archive)

### Where do I find a file's real name in an export?

In `manifest.json`. Each file's entry has its `name` and, under
`currentVersion.path`, the path of its content in the archive.

More: [Export, The layout of the archive](../organizations/export.md#the-layout-of-the-archive)

### Which extension do files get in the archive?

One that comes from the file's type, for example `png`, `pdf` or `txt`. A
file of an unknown type gets `bin`; its real type is in `mime`.

More: [Export, The layout of the archive](../organizations/export.md#the-layout-of-the-archive)

### Is the archive compressed?

Yes. Entries are compressed.

More: [Export, The layout of the archive](../organizations/export.md#the-layout-of-the-archive)

### Which dates do the entries of the archive carry?

Each file entry carries the date its version was made. `manifest.json`
carries the date the export was requested.

More: [Export, The layout of the archive](../organizations/export.md#the-layout-of-the-archive)

### What happens to two files with the same name in one folder?

No clash. Entries are named by file ID, and names live only in the
manifest.

More: [Export, The layout of the archive](../organizations/export.md#the-layout-of-the-archive)

### How big is my export?

The size is shown when it is ready: "Export ready: {size}, available until
{date}." In the API it is `sizeBytes`.

More: [Export, In the app](../organizations/export.md#in-the-app)

## The manifest

### What is `manifest.json`?

A JSON file in the archive that describes everything exported: the
organization, and its workspaces and organization folder, each with its files,
folders, tags, statuses and fields.

More: [Export, The manifest](../organizations/export.md#the-manifest)

### What do `format` and `version` say in the manifest?

`format` is always `talewright-organization-export` and `version` is `2`.

More: [Export, The manifest](../organizations/export.md#the-manifest)

### How do I rebuild my folder structure from an export?

Read `folders` to build the tree from `id` and `parentID`. Then place each
entry of `assets` in its `folderID` under its `name`, taking the content
from `currentVersion.path`.

More: [Export, The manifest](../organizations/export.md#the-manifest)

### How do I check that an exported file arrived intact?

Compute the SHA-256 of the archive entry at `currentVersion.path` and
compare it with `currentVersion.digest`.

More: [Export, The manifest](../organizations/export.md#the-manifest)

### What does `currentVersion` hold?

The version's ID and number, the version it replaced, its `digest`, its
size in bytes, when and by whom it was made, its `path` in the archive and
its type (`mime`).

More: [Export, The manifest](../organizations/export.md#the-manifest)

### What does `parentVersionID` tell me?

The version the current one replaced. It is `null` for a first version.

More: [Export, The manifest](../organizations/export.md#the-manifest)

### How are tags written in the manifest?

A file has `tagIDs`. The names are in the `tags` of the same workspace or
of the organization folder.

More: [Export, The manifest](../organizations/export.md#the-manifest)

### How is a file's status written in the manifest?

As `statusID`, or `null` without one. The statuses themselves are in the
same workspace's or the organization folder's `statuses`, in their order,
each with whether it allows public use and whether it is the default.

More: [Export, The manifest](../organizations/export.md#the-manifest)

### How are custom field values written in the manifest?

In `fields`, by field ID. A text field's value is a string, a number
field's a number, a date field's a date as `YYYY-MM-DD`, a single-choice
field's the ID of the chosen choice, and a multiple-choice field's a list
of choice IDs.

More: [Export, The manifest](../organizations/export.md#the-manifest)

### What does a file without status, tags or field values look like in the manifest?

`statusID` is `null`, `tagIDs` is `[]` and `fields` is `{}`. Empty values
are written, not left out.

More: [Export, Edge cases](../organizations/export.md#edge-cases)

### In what order are workspaces and files listed in the manifest?

Workspaces in the order they were created, and the files of each in the
order they were created.

More: [Export, The manifest](../organizations/export.md#the-manifest)

### Does the manifest list tags that no file uses?

Yes. `tags` lists every tag of that workspace or the organization folder by
name, also tags no file uses.

More: [Export, The manifest](../organizations/export.md#the-manifest)

### What is `requestedAt` in the manifest?

When the export was started.

More: [Export, The manifest](../organizations/export.md#the-manifest)

### Which kinds of fields can `fileFields` hold?

`text`, `number`, `date`, `select` and `multiSelect`. The two choice kinds
also list their choices.

More: [Export, The manifest](../organizations/export.md#the-manifest)

### How do I read the manifest without unpacking the whole archive?

Print just that entry:

```sh
unzip -p export.zip manifest.json | head
```

More: [Export, Handing a download to a script](../organizations/export.md#handing-a-download-to-a-script)

### What does a `digest` look like?

`sha256:` followed by 64 hexadecimal characters.

More: [Export, The manifest](../organizations/export.md#the-manifest)

### How does the manifest describe the organization folder?

`library` has the same five lists as a workspace: `assets`, `folders`,
`tags`, `statuses` and `fileFields`.

More: [Export, The manifest](../organizations/export.md#the-manifest)

### How do I know which folder a file was in?

Its `folderID` names the folder, or is `null` at the top level. The folder
names and parents are in `folders` of the same workspace or the organization
folder.

More: [Export, The manifest](../organizations/export.md#the-manifest)

## States and the email

### Which states can an export have?

Four: `pending` while it is built, `ready` when the archive can be
downloaded, `failed` when it could not be built, and `expired` when the
archive's 7 days are over.

More: [Export, States](../organizations/export.md#states)

### How do I know my export is ready?

The section shows "Export ready" by itself, and the person who started it
gets the email "Your {organization} export is ready".

More: [Export, The email](../organizations/export.md#the-email)

### Why did my export fail?

An export fails when it cannot be built after repeated attempts, when a
file's stored content does not match its digest, when the organization is
deleted before the archive is ready, or when it is still pending 24 hours
after it was started.

More: [Export, States](../organizations/export.md#states)

### The export failed. What do I do?

Start a new one. A failed export is not retried by itself.

More: [Export, States](../organizations/export.md#states)

### Am I emailed when an export fails?

No. No email is sent for a failed export. The section shows "The export
failed. Start a new one."

More: [Export, States](../organizations/export.md#states)

### What does "This export has expired. Start a new one." mean?

The archive's 7 days are over and it is deleted. It cannot be revived.

More: [Export, In the app](../organizations/export.md#in-the-app)

### What does "This export is not available. Start a new one." mean?

The export named in the page's address does not exist in this organization.

More: [Export, In the app](../organizations/export.md#in-the-app)

### What does "Could not check the export. Reload the page to try again." mean?

The export's state could not be read. Reload the page. While the page reads
the state it shows "Checking the export."

More: [Export, In the app](../organizations/export.md#in-the-app)

### What happens to an export that stays pending for a long time?

After 24 hours it becomes `failed`. Something went wrong and it will not
finish.

More: [Export, Limits](../organizations/export.md#limits)

### Who gets the "export ready" email?

The person who started the export. Nobody else does.

More: [Export, The email](../organizations/export.md#the-email)

### What does the export email say?

Its subject is "Your {organization} export is ready". It says the export is
ready to download, has the button "Download export" and adds "The export is
kept for 7 days."

More: [Export, The email](../organizations/export.md#the-email)

### Does the button in the export email download the archive directly?

No. It opens the organization's General settings page with this export
shown. You must be signed in as an owner or admin of the organization.
There you choose "Download export".

More: [Export, The email](../organizations/export.md#the-email)

### I started the export but my colleague did not get an email. Why?

Only the person who started it is emailed. Any owner or admin can download
it from the page if they have its address.

More: [Export, The email](../organizations/export.md#the-email)

### Why did I not get the "export ready" email?

Someone else started the export, or you were no longer an owner or admin of
the organization when it became ready. A failed export sends no email
either.

More: [Export, The email](../organizations/export.md#the-email)

### A second admin chose "Start export" while mine was pending. Who gets the email?

You do. The second admin gets your pending export, and the email goes only
to the person who started it.

More: [Export, The email](../organizations/export.md#the-email)

### What happens if the person who started the export is removed before it is ready?

No email is sent. The export still becomes ready, and the owners and admins
can download it if they have its ID.

More: [Export, The email](../organizations/export.md#the-email)

### I opened the link from the export email and got "Not found". Why?

You are signed in as an account that is not an owner or admin of the
organization. The email's link is a page of the app, not a download.

More: [Export, The email](../organizations/export.md#the-email)

### Can an export go back from failed or expired to ready?

No. A pending export becomes `ready` or `failed`, and a ready export
becomes `expired`. Nothing else changes state.

More: [Export, States](../organizations/export.md#states)

## Downloading and keeping

### How do I download an export?

When the section shows "Export ready", choose "Download export". It fetches
a fresh link and starts the download of `export-<exportID>.zip`.

More: [Export, In the app](../organizations/export.md#in-the-app)

### How long can I download an export?

For 7 days after it became ready. The section shows the date.

More: [Export, Retention](../organizations/export.md#retention)

### How long does a download link work?

At most 15 minutes, and never past the moment the export expires.

More: [Export, Downloading](../organizations/export.md#downloading)

### The download link stopped working. Why?

Each link works for at most 15 minutes. Choose "Download export" again for
a fresh one, as long as the export has not expired.

More: [Export, Downloading](../organizations/export.md#downloading)

### Can I download the same export more than once?

Yes. Reading the export again gives a fresh link, as often as you like
while the export is ready.

More: [Export, Downloading](../organizations/export.md#downloading)

### Is the download link safe to share?

No. Anyone with the link can download the whole archive while it is valid,
without signing in.

More: [Export, Downloading](../organizations/export.md#downloading)

### Does downloading the archive need a sign-in?

Getting a link does: you must be signed in as an owner or admin. The link
itself carries its own proof and works without signing in for its short
time.

More: [Export, Downloading](../organizations/export.md#downloading)

### The export expired. Can I get it back?

No. An expired export cannot be revived. Start a new one.

More: [Export, Retention](../organizations/export.md#retention)

### What happens to the archive when its 7 days are over?

The export reads as `expired` and gives no link. The archive is deleted
shortly afterwards, and links handed out earlier stop working.

More: [Export, Retention](../organizations/export.md#retention)

### Can I delete an export before it expires?

No. An archive is deleted when its 7 days are over. Keep its download links
to yourself in the meantime.

More: [Export, Retention](../organizations/export.md#retention)

### Where is the list of earlier exports?

There is none. Keep the email or the page's address to return to an export.

More: [Export, Finding an export again](../organizations/export.md#finding-an-export-again)

### How do I find an export again?

By its ID. The ID is in the answer when the export is started, in the
address of the settings page while you look at it (`?export=<exportID>`),
and in the link of the "export ready" email.

More: [Export, Finding an export again](../organizations/export.md#finding-an-export-again)

### Why does the page show only "Start export" although I exported before?

Opening the page without an export in its address shows only "Start
export", also when earlier exports exist. Open the page from the email or
from a bookmark that holds the export.

More: [Export, In the app](../organizations/export.md#in-the-app)

### Can I bookmark an export?

Yes. The page's address holds the export, so reloading or bookmarking the
page shows the same export again.

More: [Export, In the app](../organizations/export.md#in-the-app)

### What does "Could not start the download. Try again." mean?

A fresh download link could not be fetched. Try again. The matching message
for starting is "Could not start the export. Try again."

More: [Export, In the app](../organizations/export.md#in-the-app)

### The page shows "Export ready" but no download starts. Why?

The export expired while the page was open. "Download export" fetches the
state first, finds it expired and starts no download. The section then
shows "This export has expired. Start a new one."

More: [Export, Edge cases](../organizations/export.md#edge-cases)

### What happens to a ready export when the organization is deleted?

It cannot be read while the organization is deleted, and its 7 days keep
running. After a restore it can be downloaded again if it has not expired.

More: [Export, Edge cases](../organizations/export.md#edge-cases)

### What happens to a pending export when the organization is deleted?

It becomes `failed`. No archive is kept and no email is sent. After a
restore, start a new one.

More: [Export, States](../organizations/export.md#states)

### What happens to exports when the organization is removed for good?

Its exports and archives are removed with it.

More: [Export, Retention](../organizations/export.md#retention)

### Should I export before deleting an organization?

If you want to keep the files, yes. A deleted organization cannot be
exported, and after 30 days its files are gone for good.

More: [Export, Questions and answers](../organizations/export.md#questions-and-answers)

### Can I import an export into another organization?

No. There is no import. The archive is a copy to keep.

More: [Export, Questions and answers](../organizations/export.md#questions-and-answers)

### A download link was requested seconds before the export expired. How long does it work?

Only until the expiry, so less than 15 minutes. A link never outlives its
archive.

More: [Export, Downloading](../organizations/export.md#downloading)

### From when are the 7 days of an export counted?

From the moment it became ready, not from when it was started. A ready
archive is kept for 168 hours. `expiresAt` is that moment.

More: [Export, Retention](../organizations/export.md#retention)

## The API and agents

### Can an agent start an export?

No. Exports are for people. Both operations need a browser session, and
neither is an MCP tool. A credential gets `403 FORBIDDEN` with
`details.reason` `SESSION_REQUIRED`.

More: [Export, For agents](../organizations/export.md#for-agents)

### Which API operations exist for exports?

Two: `POST /v1/organizations/{organizationID}/exports` starts one, and
`GET /v1/organizations/{organizationID}/exports/{exportID}` reads it. Both
answer with the export.

More: [Export, For agents](../organizations/export.md#for-agents)

### What does the API answer when an export is started?

`202` with the export in state `pending`. `POST` takes no body.

More: [Export, Starting](../organizations/export.md#starting)

### How do I wait for an export through the API?

Read it again every few seconds until `state` is no longer `pending`.

More: [Export, For agents](../organizations/export.md#for-agents)

### What does an export look like in the API?

It has `id`, `state`, `createdAt`, `completedAt`, `expiresAt`, `sizeBytes`
and `downloadURL`. Which of them are set depends on the state.

More: [Export, States](../organizations/export.md#states)

### Can I hand the download link to a script?

Yes. A person can pass the `downloadURL` to a script or an agent. It needs
no credential, but it must be used within 15 minutes:

```sh
curl -L -o export.zip "$DOWNLOAD_URL"
```

More: [Export, Handing a download to a script](../organizations/export.md#handing-a-download-to-a-script)

### Should the download request carry cookies or an `Authorization` header?

No. Fetch the link without cookies and without an `Authorization` header.
The link carries its own proof.

More: [Export, Downloading](../organizations/export.md#downloading)

### What can an agent do in place of an export?

It uses the file tools with its own credential: it lists files and
downloads the versions it needs.

More: [Export, What an agent can do instead](../organizations/export.md#what-an-agent-can-do-instead)

### Why does starting an export answer `409 CONFLICT`?

Rarely, an export finishes at the very moment another start arrives. The
message reads "an export just finished; request again". Starting again
works.

More: [Export, Errors](../organizations/export.md#errors)

### What does `404 NOT_FOUND` mean for an export?

The organization is unknown, deleted or not yours, or the export does not
exist in it. An export is read only within its own organization.

More: [Export, Errors](../organizations/export.md#errors)

### Is a failed export an error answer in the API?

No. It is an export in state `failed`, read with `200`.

More: [Export, Errors](../organizations/export.md#errors)

### Is exporting recorded in the audit trail?

Yes. `export.requested` is recorded for the person who started it, and
`export.completed` or `export.failed` when it finishes.

More: [Audit trail, Export](../reference/audit-trail.md#export)

### When is `downloadURL` set on an export?

Only while the export is `ready`. Each `GET` of a ready export carries a
fresh `downloadURL`. In every other state it is `null`.

More: [Export, States](../organizations/export.md#states)

