---
title: "Download Documents as ZIP"
method: POST
path: "/datasets/{dataset_id}/documents/download-zip"
tags: ["Documents"]
---

# Download Documents as ZIP

`POST /datasets/{dataset_id}/documents/download-zip`

Downloads one or more documents as a single ZIP archive. Only documents that were uploaded as files can be included.

## Path parameters

- `dataset_id` string, uuid, required

## Request body

- object
  - `document_ids` string[], required — Document IDs to include in the archive. Get them from [List Documents](/en/api-reference/documents/list-documents).

## Response `200`

ZIP archive containing the requested documents.

## Other responses

- `403` — - `forbidden` : Knowledge base API access is not enabled. - `forbidden` : Sorry, you have reached the knowledge base request rate limit of your subscription. - `forbidden` : You do not have permission to access this knowledge base. - `forbidden` : You do not have permission for one of the requested documents.
- `404` — - `not_found` : Document not found. - `not_found` : Knowledge base not found. Also returned as "Only uploaded-file documents can be downloaded as ZIP." when a requested document has no uploaded file.

---

[API](https://skmtc.net/langgenius/apis/dify-service-api.md) · [All operations](https://skmtc.net/langgenius/apis/dify-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/langgenius/dify-service-api/versions/361dc12484f4/schema)