---
title: "Download Single"
method: POST
path: "/download/single"
tags: ["downloading"]
---

# Download Single

`POST /download/single`

Download a single file to S3

Requires permission: download:write

## Request body

- SingleDownloadRequest — Request model for single file download
  - `url` string, uri, required — URL to download
  - `s3_key` string, nullable — S3 key for the file
  - `wait_until` 'domcontentloaded' | 'load' | 'networkidle' | 'commit' — When to consider page load complete for web scraping operations
  - `downloader_type` 'FLEET_ASYNC' — Available downloader types
  - `timeout_ms` integer — Timeout in milliseconds

## Response `200`

Successful Response

- SingleDownloadResponse — Response model for single file download
  - `success` boolean, required
  - `job_id` string, nullable
  - `download_url` string, required
  - `s3_bucket` string, required
  - `s3_key` string, required
  - `error` string, nullable

## Other responses

- `422` — Validation Error

## Changes

- **2026-02-17** `29225d7b3ea4` — 1 warning, 2 info
  - removed the request property `s3_bucket`
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2025-08-23** `350e41758f41` — 1 warning, 1 info
  - removed the request property `timeout`
  - added the new optional request property `timeout_ms`
- **2025-08-12** `707c0eb9cee1` — 1 breaking, 2 info
  - removed the enum value `async_fleet` of the request property `downloader_type`
  - the `downloader_type` request property default value changed from `async_fleet` to `FLEET_ASYNC`
  - added the new `FLEET_ASYNC` enum value to the request property `downloader_type`

[Change history](https://skmtc.dev/evrimai/apis/cartography-server/changes/download/single/post.md)

---

[API](https://skmtc.dev/evrimai/apis/cartography-server.md) · [All operations](https://skmtc.dev/evrimai/apis/cartography-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/evrimai/cartography-server/revisions/5ee44bc43d24/schema)