Skip to main content

Data Export

Think of an export as a backup of your data in a portable format — like exporting your contacts to a CSV before switching phones. Useful for migrations, compliance archives, offline analysis, or just keeping a copy of what's yours.

What you'll learn​

  • The kinds of data you can export
  • How to create + download an export
  • Format choices (JSON / CSV)
  • Permissions: who can export what

What you can export​

TypeWhat it includes
WorkspaceEverything in a workspace — members, projects, tags, files (metadata)
ProjectA single project plus its resources
ConversationsMessages, channels, attachments metadata
FilesFile metadata (and optionally the file contents themselves)
TagsYour tag taxonomy + assignments
GroupsGroup membership snapshot
Audit logA range of audit events (typically for compliance)

You can also bundle multiple types into a single export if you want, for example, "everything I own in this workspace."

Create an export​

From the web app:

  1. Open Settings → Data Export → New Export.
  2. Pick the data types you want (one or many).
  3. Pick the format — JSON for structured, lossless data; CSV when you want to open it in a spreadsheet.
  4. (Optional) Restrict to a date range.
  5. Click Create export.

You'll see the export move through these stages:

Queued → Running → Ready → Downloaded

Big exports run in the background. You'll get a notification when it's ready.

Download the export​

When the status hits Ready:

  1. Open the export from Settings → Data Export.
  2. Click Download. You'll get a single archive (.zip for multi-type, or a single file for one type).
  3. The download link expires after 7 days. Re-run the export if you need it again later.

Format choices​

FormatUse when
JSONYou're migrating to another tool, archiving for compliance, or running scripts
CSVYou want to open it in Excel / Sheets / a data tool

JSON exports preserve every field (including nested objects, timestamps, IDs). CSV flattens nested data and is lossier.

Permissions: who can export what​

Exports always respect your existing permissions — you can only export data you can already see.

  • Workspace members can export their own activity + anything they own
  • Workspace admins can export workspace-wide data
  • Tenant admins can export tenant-wide data (every workspace)
  • Audit log exports require an extra permission (audit.export) — usually held by compliance / security roles

If a teammate exports a workspace, every member of that workspace sees an entry in the audit log noting who did it, when, and what scope.

Privacy + retention​

Exports include only the data you have permission to see, never other tenants' data, and never secrets or passwords (those are never persisted in a recoverable form to begin with).

We keep the downloadable export file for 7 days then delete it. The export record (who ran it, when, what scope) stays in the audit log per your tenant's retention policy.

Troubleshooting​

SymptomWhat to try
Export stuck on Queued for more than 10 minCheck the status page. Re-create if the queue is healthy.
Failed status with no errorOpen the export and look at the Last error field. Most common cause: permission change mid-run.
Download link returns 403Link expired (7 days). Re-create the export.
File is much smaller than expectedA date-range filter or scope restriction may be in effect. Check the export's settings.

Next steps​