---
title: "Async Create Torrent"
method: POST
path: "/v1/api/torrents/asynccreatetorrent"
tags: ["torrents"]
---

# Async Create Torrent

`POST /v1/api/torrents/asynccreatetorrent`

## Request

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

Creates a torrent from a file or magnet link. Requires API key. This is an async version of the /createtorrent endpoint that returns immediately and processes the request in the background.

## Request body `multipart/form-data`

- BodyAsyncCreateTorrentV1ApiTorrentsAsynccreatetorrentPost
  - `file` string, binary, nullable
  - `magnet` string, nullable
  - `seed` integer, nullable
  - `allow_zip` boolean, nullable
  - `name` string, 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/torrents/asynccreatetorrent/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)