---
title: "Upload file"
method: POST
path: "/upload"
tags: ["Upload"]
---

# Upload file

`POST /upload`

Create a new file upload session via the [tus protocol](https://tus.io). Returns an upload URL in Location header.    You can use one of the [available clients](https://tus.io/implementations) or implement your own client following the protocol specification.

## Headers

- `Upload-Length` integer, required
- `Upload-Metadata` string, required
- `Tus-Resumable` string, required

## Response `201`

Upload session created successfully. Use Location header URL for PATCH requests.

## Other responses

- `307` — Redirect to correct datacenter
- `400` — Bad request or invalid metadata
- `401` — Unauthorized
- `403` — Forbidden - no project access

---

[API](https://skmtc.dev/bimtrackapp/apis/newforma-konekt-document-control-api.md) · [All operations](https://skmtc.dev/bimtrackapp/apis/newforma-konekt-document-control-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bimtrackapp/newforma-konekt-document-control-api/revisions/4671d430ce39/schema)