---
title: "Async Create Usenet Download"
method: POST
path: "/v1/api/usenet/asynccreateusenetdownload"
tags: ["usenet downloads"]
---

# Async Create Usenet Download

`POST /v1/api/usenet/asynccreateusenetdownload`

## Request

- Base URL: `https://api.torbox.app`
- URL: `https://api.torbox.app/v1/api/usenet/asynccreateusenetdownload`
- Auth: OAuth 2
  - Password
  - Token URL: `token`

Creates a usenet download from a link or nzb file. Requires API key.

## Request body `multipart/form-data`

- BodyAsyncCreateUsenetDownloadV1ApiUsenetAsynccreateusenetdownloadPost
  - `link` string, nullable
  - `file` string, binary, nullable
  - `name` string, nullable
  - `password` string, nullable
  - `post_processing` integer, nullable
  - `as_queued` boolean, nullable
  - `add_only_if_cached` boolean, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `404`: Not Found
- `422`: Validation Error

## Changes

- **2026-06-22** `4ef25276ebb3`: 1 breaking, 3 info
  - the `file/anyOf[subschema #1]/` request property contentMediaType changed from `` to `application/octet-stream`
  - the `file/anyOf[subschema #1]/` request property format was generalized from `binary` to no format
  - 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

[Operation history](https://skmtc.dev/torbox/apis/torbox-api/changes/v1/api/usenet/asynccreateusenetdownload/post.md)

---

[API](https://skmtc.dev/torbox/apis/torbox-api.md) - [All operations](https://skmtc.dev/torbox/apis/torbox-api/llms.txt) - [OpenAPI document](https://skmtc.dev/torbox/apis/torbox-api/revisions/354dcd8c25f4?raw)