---
title: "Changes to Create File"
method: POST
path: "/files"
---

# Changes to Create File

`POST /files`

> Every recorded change to this endpoint, newest first.
> 74 revisions in range; 1 not diffed.

## Timeline

Changed in 1 of 74 revisions.

- **2026-08-24** `e91d507bda45` — 4 breaking, 2 warning, 14 info

## Changes

- **2026-08-24** `e91d507bda45` — 4 breaking, 2 warning, 14 info
  - request property `visibility` was restricted to a list of enum values
  - removed `#/components/schemas/FileVisibility, subschema #2` from the `visibility` request property `oneOf` list
  - the `visibility` request property type changed from no type to `string`
  - removed the success response with the status `200`
  - removed the optional property `error/param` from the response with the `400` status
  - removed the optional property `error/param` from the response with the `401` status
  - added the new optional `header` request parameter `Api-Version-Date` to all path's operations
  - added the new optional `header` request parameter `Idempotency-Key`
  - added the new optional request property `byte_size`
  - added the new optional request property `multipart`
  - request body became optional
  - added the new `private` enum value to the request property `visibility`
  - added the new `public` enum value to the request property `visibility`
  - added the non-success response with the status `409`
  - removed the non-success response with the status `403`
  - removed the non-success response with the status `404`
  - removed the non-success response with the status `422`
  - removed the non-success response with the status `429`
  - removed the non-success response with the status `500`
  - added the success response with the status `201`

---

[Operation](https://skmtc.dev/whop/apis/whop-api/docs/files/post.md) · [API](https://skmtc.dev/whop/apis/whop-api.md) · [Page](https://skmtc.dev/whop/apis/whop-api/changes/files/post)