---
title: "Upload file"
method: POST
path: "/api/files"
tags: ["Files"]
---

# Upload file

`POST /api/files`

Stores a file via multipart upload and returns a download link. Only safe file types accepted. Reuse existing owner token to group entities under one owner

## Query parameters

- `ns` string
- `tags` string
- `ttl` string

## Headers

- `X-Password` string
- `X-Owner-Token` string

## Request body

- object
  - `file` string, binary, required

## Response `201`

File uploaded

## Other responses

- `400` — Invalid request or file too large
- `415` — Unsupported file type
- `429` — Rate limit exceeded

---

[API](https://skmtc.net/brewpage/apis/brewpage-api.md) · [All operations](https://skmtc.net/brewpage/apis/brewpage-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/brewpage/brewpage-api/revisions/6e0ac03e39e5/schema)