---
title: "Export a single item to a downloadable file"
method: POST
path: "/api/v3/document-export"
tags: ["documentExport"]
---

# Export a single item to a downloadable file

`POST /api/v3/document-export`

## Request

- Base URL: `https://{tenant_name}.benchling.com`
- URL: `https://{tenant_name}.benchling.com/api/v3/document-export`
- Auth: HTTP bearer

Create an asynchronous task that exports a single item that can be downloaded as a ZIP
archive. The task can be polled via the returned `pollingUri` for status and, on success,
a download link.

Supported item types are resolved from the `id` prefix: notebook entries (`etr_`),
worksheets (`wks_`), sequences (`seq_`), proteins (`prtn_`), and molecules (`mol_`).

In rare cases, attachments still being scanned for viruses are omitted from the export.

## Headers

- `EARLY-ACCESS` string

## Request body

- object
  - `format` 'pdf' | 'html': Export format. Only supported for notebook entries (`pdf` or `html`, default `pdf`). All other item types render to their single native output, so providing `format` for a non-entry item is rejected with a 400.
  - `id` string, required: API ID of the item to export.

## Response `202`

Export task started

- DocumentExportCreateResponse202
  - `pollingUri` string, required
  - `taskId` string, required

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/benchling/apis/benchling-api.md) - [All operations](https://skmtc.dev/benchling/apis/benchling-api/llms.txt) - [OpenAPI document](https://skmtc.dev/benchling/apis/benchling-api/revisions/c9f087b98b8b?raw)