---
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_bucket` string, required — S3 bucket for storage
  - `s3_key` string, nullable — S3 key for the file
  - `wait_until` 'commit' | 'domcontentloaded' | 'load' | 'networkidle' — When to consider download complete
  - `downloader_type` 'async_fleet' — Available downloader types
  - `timeout` 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

---

[API](https://skmtc.dev/evrimai/apis/cartography-server.md) · [All operations](https://skmtc.dev/evrimai/apis/cartography-server/llms.txt) · [OpenAPI document](https://skmtc.dev/evrimai/apis/cartography-server/revisions/4eb68ae85080?raw)