---
title: "Upload a file (≤ 50 MB, kept 24 h)"
method: POST
path: "/v1/uploads"
tags: ["Uploads"]
---

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

`POST /v1/uploads`

## Request

- Base URL: `https://api-eu.dynamicdocumentapi.com`
- URL: `https://api-eu.dynamicdocumentapi.com/v1/uploads`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Headers

- `Idempotency-Key` string

## Response `201`

- Upload
  - `bytes` integer
  - `created_at` string, date-time
  - `expires_at` string, date-time
  - `filename` string
  - `id` string
  - `mime` string
  - `object` 'upload'
  - `sha256` string

## Other responses

- `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`).

---

[API](https://skmtc.dev/dynamicdocumentapi/apis/dynamic-document-api.md) · [All operations](https://skmtc.dev/dynamicdocumentapi/apis/dynamic-document-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dynamicdocumentapi/apis/dynamic-document-api/revisions/0f14bc0000f4?raw)