---
title: "Changes to Create a file upload"
method: POST
path: "/v1/file_uploads"
---

# Changes to Create a file upload

`POST /v1/file_uploads`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 38 revisions.

- **2026-08-15** `c90a4587bc95`: 1 warning
- **2026-08-13** `ae20477af71b`: 1 breaking, 1 info
- **2026-08-12** `28d140865fc6`: 2 warning
- **2026-08-05** `0470d9397de2`: 1 breaking
- **2026-08-04** `06b66c7458c6`: 1 info
- **2026-07-31** `301eea0116d9`: 2 warning
- **2026-07-26** `681ee94f046c`: 3 warning

## Changes

- **2026-08-15** `c90a4587bc95`: 1 warning
  - added the new `idempotency_key_reused` enum value to the `allOf[subschema #2]/code` response property for the response status `409`
- **2026-08-13** `ae20477af71b`: 1 breaking, 1 info
  - added `subschema #1, subschema #2, subschema #3` to the response body `oneOf` list for the response status `403`
  - removed `#/components/schemas/publicApiCommonErrorResponse, subschema #2` from the response body `allOf` list for the response status `403`
- **2026-08-12** `28d140865fc6`: 2 warning
  - added the new `agent_credit_limit_reached` enum value to the `allOf[subschema #2]/code` response property for the response status `403`
  - added the new `workspace_credits_exhausted` enum value to the `allOf[subschema #2]/code` response property for the response status `403`
- **2026-08-05** `0470d9397de2`: 1 breaking
  - request body became required
- **2026-08-04** `06b66c7458c6`: 1 info
  - request body became optional
- **2026-07-31** `301eea0116d9`: 2 warning
  - added the new `invalid_beta` enum value to the `allOf[subschema #2]/code` response property for the response status `400`
  - added the new `invalid_credit_limit` enum value to the `allOf[subschema #2]/code` response property for the response status `400`
- **2026-07-26** `681ee94f046c`: 3 warning
  - added the new `agent_deleted` enum value to the `allOf[subschema #2]/code` response property for the response status `409`
  - added the new `directory_not_found` enum value to the `allOf[subschema #2]/code` response property for the response status `404`
  - added the new `status_change_not_allowed` enum value to the `allOf[subschema #2]/code` response property for the response status `403`

---

[Operation](https://skmtc.dev/notion/apis/notion-api/docs/v1/file_uploads/post.md) - [API](https://skmtc.dev/notion/apis/notion-api.md) - [Page](https://skmtc.dev/notion/apis/notion-api/changes/v1/file_uploads/post)