---
title: "Create a download request for assets in an AOI"
method: POST
path: "/v0/aois/{aoi_id}/downloads"
tags: ["Downloads"]
---

# Create a download request for assets in an AOI

`POST /v0/aois/{aoi_id}/downloads`

## Request

- Base URL: `https://api.pixxel.space`
- URL: `https://api.pixxel.space/v0/aois/{aoi_id}/downloads`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/pixxel/apis/stargate/docs/v0/aois/:aoi_id/downloads/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a download request for specified assets in an AOI

## Path parameters

- `aoi_id` string, required

## Request body

- AtlasDownloadCreateModel
  - `asset_ids` string[], required

## Response `201`

Created

- AtlasDownloadReadModel
  - `download_id` string
  - `signed_url` string
  - `status` string

## Other responses

- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/pixxel/apis/stargate.md) - [All operations](https://skmtc.dev/pixxel/apis/stargate/llms.txt) - [OpenAPI document](https://skmtc.dev/pixxel/apis/stargate/revisions/519562bd9d7a?raw)