---
title: "Export documents (async)"
method: POST
path: "/v1/default/banks/{bank_id}/document-transfer/export"
tags: ["Document Transfer"]
deprecated: true
---

# Export documents (async)

`POST /v1/default/banks/{bank_id}/document-transfer/export`

## Request

- Base URL: `https://hindsight.vectorize.io` (the document declares no server; this is the origin it was published from)
- URL: `https://hindsight.vectorize.io/v1/default/banks/{bank_id}/document-transfer/export`
- Auth: none declared
- TypeScript: <https://skmtc.dev/vectorize/apis/hindsight-http-api/docs/v1/default/banks/:bank_id/document-transfer/export/post.ts> (a function with typed inputs; its response is checked against the schema)

> **Deprecated.**

Submit an async export of a bank's documents (extracted facts, entity names, causal links, chunks) as a transfer ZIP archive. Embeddings and database ids are not included — importing re-embeds with the target bank's model and re-resolves entities. Runs as a background operation to avoid pinning the API on large banks. Returns an operation_id; poll GET /v1/default/banks/{bank_id}/operations/{operation_id}. On completion the operation's result_metadata carries download_url (fetch the ZIP from GET /v1/default/files/download/{key}), storage_key, byte_size, and filename. Pass document_id query params to export specific documents, or omit to export the whole bank; include_observations=true carries consolidated observations and include_knowledge_base=true carries Mental Models plus Knowledge Pages (all whole-bank export only).

## Path parameters

- `bank_id` string, required

## Query parameters

- `document_id` string[], nullable: Document id(s) to export; omit for all
- `include_observations` boolean: Also export consolidated observations (restored on import; whole-bank only)
- `include_knowledge_base` boolean: Also export Mental Models and Knowledge Pages (restored on import; whole-bank only)

## Headers

- `authorization` string, nullable

## Response `202`

Successful Response

- DocumentExportSubmitResponse: Response for the async document-export endpoint (202). The export runs in the background; poll the operations endpoint for status. On completion the operation's ``result_metadata`` carries ``download_url`` (fetch the ZIP from GET /v1/default/files/download/{key}), ``storage_key``, ``byte_size``, and ``filename``.
  - `operation_id` string, required
  - `status` string

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-04** `4fda98b75f63`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/vectorize/apis/hindsight-http-api/changes/v1/default/banks/:bank_id/document-transfer/export/post.md)

---

[API](https://skmtc.dev/vectorize/apis/hindsight-http-api.md) - [All operations](https://skmtc.dev/vectorize/apis/hindsight-http-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vectorize/apis/hindsight-http-api/revisions/45e711cd0897?raw)