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

# Import documents (async)

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

## 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`
- Auth: none declared
- TypeScript: <https://skmtc.dev/vectorize/apis/hindsight-http-api/docs/v1/default/banks/:bank_id/document-transfer/post.ts> (a function with typed inputs; its response is checked against the schema)

> **Deprecated.**

Submit a transfer archive (produced by the export endpoint) for import into a bank. Runs as a background operation: facts are re-embedded with the target bank's embedding model and entities are re-resolved — no LLM extraction. Returns an operation_id; poll GET /v1/default/banks/{bank_id}/operations/{operation_id} for status and the imported/skipped counts in result_metadata. Use on_conflict to control existing document ids: skip (default), replace, or new-id.

## Path parameters

- `bank_id` string, required

## Query parameters

- `on_conflict` string: skip | replace | new-id

## Headers

- `authorization` string, nullable

## Request body `multipart/form-data`

- BodyImportDocuments
  - `file` string, binary, required: Transfer ZIP archive

## Response `202`

Successful Response

- DocumentImportSubmitResponse: Response for the async document-import endpoint (202). The import runs in the background; poll the operations endpoint for status. The imported/skipped counts (documents_imported, facts_imported, observations_imported, etc.) are written to the operation's result_metadata.
  - `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/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)