---
title: "Exports"
description: "A zip of the whole workspace."
url: "https://openemail.uk/docs/mcp/tools/exports"
area: "MCP server"
category: "Tools"
---

# Exports

A zip of the whole workspace.

## Exports tools

| Tool | What it does |
| --- | --- |
| getExportPreview | Whether an export can start now, when the next one can, the export still being made and how much an export would hold. |
| listExports | The exports of the workspace, newest first, with their status, progress and size. |
| getExport | One export by its id. |
| startExport | Start making a zip of the whole workspace, once a day. It asks for a verification code, and in the app’s chat it always asks first. |

> Only the workspace owner, or a member whose role holds every permission, can export, through a client connected with every address. Every tool needs `threads:read`.

> No tool returns the zip. Download it on the Export page of the app, with `GET /exports/{id}/content` on the REST API, `exports.download` in the SDK or `openemail exports download` on the command line.

> Some tools on this server make a change the REST API guards with a verification code, and ask for the same code. Until the client has verified a code in the last 60 minutes, or the person has chosen Allow changes for 60 minutes on it in Account → Connected apps, such a tool answers with a result that starts `Refused (step_up_required):` and changes nothing. `emptyAudience` never asks for a code. The API Authentication page lists every tool that asks, and shows how to ask for a code and verify it.

## Reference

### `getExportPreview`

Whether this workspace can be exported now, when the next export can start, the export still being made, and how much an export would hold: conversations, attachments, contacts, audiences, calendar events, templates, rules, labels, notes and addresses.

- Scopes: `threads:read`.
- The app's assistant runs it without asking.
- Toolkit: `workspace`.

**Inputs**

Takes no input.

Also available in: API [`GET /exports/preview`](https://openemail.uk/docs/api/reference/exports#get-exports-preview); SDK [`exports.preview()`](https://openemail.uk/docs/sdk/reference/exports#preview).

### `listExports`

The exports of this workspace, newest first, with their status, progress, size and when each is deleted. A ready one is downloaded on the Export page of the app or with GET /exports/{id}/content on the REST API.

- Scopes: `threads:read`.
- The app's assistant runs it without asking.
- Toolkit: `workspace`.

**Inputs**

- `limit` (`integer`, at least 1, at most 100)
- `offset` (`integer`, at least 0)

Also available in: API [`GET /exports`](https://openemail.uk/docs/api/reference/exports#get-exports), [`GET /exports/{id}`](https://openemail.uk/docs/api/reference/exports#get-exports-id); SDK [`exports.list()`](https://openemail.uk/docs/sdk/reference/exports#list), [`exports.get()`](https://openemail.uk/docs/sdk/reference/exports#get).

### `getExport`

One export by its id: its status, its progress through the conversations, its size and when it is deleted.

- Scopes: `threads:read`.
- The app's assistant runs it without asking.
- Toolkit: `workspace`.

**Inputs**

- `id` (`string`, required, 1 to 128 characters)

Also available in: API [`GET /exports`](https://openemail.uk/docs/api/reference/exports#get-exports), [`GET /exports/{id}`](https://openemail.uk/docs/api/reference/exports#get-exports-id); SDK [`exports.list()`](https://openemail.uk/docs/sdk/reference/exports#list), [`exports.get()`](https://openemail.uk/docs/sdk/reference/exports#get).

### `startExport`

Start making a zip of the whole workspace, as Export now on the Export page does. It is made in the background, one at a time and once a day, and kept for a year. Ask the person first.

- Scopes: `threads:read`.
- The app's assistant always asks first.
- Asks for a verification code, the same as [`POST /exports`](https://openemail.uk/docs/api/reference/exports#post-exports).
- Toolkit: `workspace`.

**Inputs**

Takes no input.

Also available in: API [`POST /exports`](https://openemail.uk/docs/api/reference/exports#post-exports); SDK [`exports.start()`](https://openemail.uk/docs/sdk/reference/exports#start).