---
title: "POST /v0/files"
method: POST
path: "/v0/files"
---

# POST /v0/files

`POST /v0/files`

Upload a file that can be referenced in the Responses API.

## Response `200`

OK

- object
  - `id` string, required
  - `object` 'file', required
  - `created_at` number, required
  - `filename` string, required
  - `bytes` number, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `422` — Unprocessable Entity
- `500` — Internal Server Error

## Changes

- **2025-12-11** `69e42ddaf375` — 3 breaking, 1 warning, 1 info
  - removed `subschema #1, subschema #2, subschema #3` from the `file` request property `anyOf` list
  - the `file` request property contentEncoding changed from `` to `binary`
  - the `file` request property's minLength was increased from `0` to `1`
  - the `file` request property's maxLength was set to `10485760`
  - …1 more
- **2025-12-11** `36d2b811bb5f` — 1 info
  - added optional request body
- **2025-12-10** `118e2caf7bb0` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/witanlabs/apis/witan-labs-api/changes/v0/files/post.md)

---

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