# Dynamic Document API: Uploads

> Temporary files for PDF tools and batches.

> Part of the Dynamic Document API documentation. Index of all pages for agents: [llms.txt](https://dynamicdocumentapi.com/llms.txt), every page in one file: [llms-full.txt](https://dynamicdocumentapi.com/llms-full.txt).

1 endpoints of the [API reference](https://dynamicdocumentapi.com/docs/api-reference/index.md), version 1.0.0. Interactive reference: https://dynamicdocumentapi.com/docs/api-reference#tag/uploads. Machine-readable OpenAPI document: https://dynamicdocumentapi.com/openapi/openapi-public.json

## Servers

- https://api-eu.dynamicdocumentapi.com — EU (Germany)

## Endpoints

- `POST /v1/uploads` — Upload a file (≤ 50 MB, kept 24 h)

## POST /v1/uploads

**Upload a file (≤ 50 MB, kept 24 h)**

Parameters:

| Name | In | Type | Description |
|---|---|---|---|
| `Idempotency-Key` | header | string | Replays the stored response for 24 h; a different body with the same key → 422. |

Request body (`multipart/form-data`): object

| Field | Type | Description |
|---|---|---|
| `file` (required) | string |  |

Responses:

- `201` 
- `401` Missing, invalid, expired or revoked credentials.
- `403` Insufficient scope, IP not allowed, workspace suspended or scheduled for deletion, or email not verified.
- `413` File too large.
- `415` Unsupported file type.
- `429` Rate limited (`Retry-After`).