---
title: "Create upload with filename"
method: POST
path: "/api/v1/uploads/{filename}"
tags: ["Upload"]
---

# Create upload with filename

`POST /api/v1/uploads/{filename}`

Uploads a document to the queue specified as query parameter with filename specified in the URL path.
UTF-8 filenames are supported and must be URL encoded.

The file should be sent in the request body. The total size of the data uploaded may not exceed 40 MB.

The endpoint is asynchronous and response contains created task url. Further information about the import status may be acquired by retrieving the upload object or the task (for more information, please refer to task).

## Path parameters

- `filename` string, required

## Query parameters

- `queue` integer, required
- `reject_identical` boolean

## Response `202`

Accepted

- object
  - `url` string, url — URL of the created task for tracking upload progress.

## Other responses

- `400` — Invalid input data.
- `401` — The username/password is invalid or token is invalid (e.g. expired).
- `403` — Insufficient permission, missing authentication, invalid CSRF token and similar issue.
- `404` — The specified resource was not found.
- `409` — Conflict
- `413` — Payload too large (especially for files uploaded).
- `429` — Request rate is too high, wait before sending more requests. See [Rate Limiting](/guides/overview#rate-limiting) for more details.
- `500` — Server failure while processing the request.
- `502` — Invalid response from the upstream server.
- `503` — We're temporarily offline for maintenance. Please try again later.
- `504` — Upstream server could not complete the request in time.

---

[API](https://skmtc.dev/rossum/apis/rossum-api.md) · [All operations](https://skmtc.dev/rossum/apis/rossum-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rossum/rossum-api/revisions/f1b5a910991d/schema)