---
title: "Download crawl raw files as a ZIP archive"
method: POST
path: "/crawls/{crawl_id}/raw-archive"
tags: ["sources"]
---

# Download crawl raw files as a ZIP archive

`POST /crawls/{crawl_id}/raw-archive`

## Request

- Base URL: `https://developer.qaip.com/api/v1`
- URL: `https://developer.qaip.com/api/v1/crawls/{crawl_id}/raw-archive`
- Auth: API key in header `x-api-key`

Downloads raw files belonging to a crawl as a ZIP archive. Omit source\_ids to download every file in the crawl, or provide source\_ids to download only the selected files.

Required scope: \`knowledge:read\`

## Path parameters

- `crawl_id` string, uuid, required

## Request body

- DownloadCrawlRawArchiveRequest
  - `source_ids` string[]: Source IDs to include. Omit to include every source in the crawl; an empty array is invalid.

## Response `200`

ZIP archive containing the selected crawl raw files

## Other responses

- `400`: Invalid crawl ID, source ID, empty source_ids, or duplicate source ID
- `401`: Unauthorized
- `404`: Crawl not found
- `409`: Crawl manifest is not available yet
- `413`: Request body is too large
- `422`: One or more source IDs do not belong to the crawl
- `500`: Internal Server Error
- `502`: The application proxy could not obtain an upstream response before forwarding response headers. The error code is unavailable and retryable is false: upstream side effects may have completed, so a 502 alone does not make retrying safe. Check the operation's idempotency and recovery contract before retrying. A failure after streaming has started instead aborts the stream without appending this JSON body. CDN or load-balancer generated errors may have a different body and are not described by this response.

## Changes

- **2026-09-17** `2489c6f1a9d8`: 29 info
  - added the non-success response with the status `502`
  - added the optional property `error/code` to the response with the `400` status
  - added the optional property `error/code` to the response with the `401` status
  - added the optional property `error/code` to the response with the `404` status
  - …25 more
- **2026-09-01** `b065e544fec5`: 1 info
  - endpoint added
- **2026-09-01** `26fef6564ef0`: 1 breaking
  - api path removed without deprecation
- **2026-08-31** `61dc40676905`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/qlonolink/apis/qaip-apis/changes/crawls/:crawl_id/raw-archive/post.md)

---

[API](https://skmtc.dev/qlonolink/apis/qaip-apis.md) - [All operations](https://skmtc.dev/qlonolink/apis/qaip-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/qlonolink/apis/qaip-apis/revisions/2489c6f1a9d8?raw)