---
title: "Changes to Upload a file"
method: POST
path: "/v1/upload_file"
---

# Changes to Upload a file

`POST /v1/upload_file`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 79 revisions.

- **2026-10-08** `04df18172f4d`: 3 info
- **2026-04-13** `85a4ba66dad1`: 1 breaking, 1 info
- **2026-04-13** `5c0ca63adfe4`: 2 breaking
- **2026-04-13** `85a4ba66dad1`: 1 breaking, 1 info

## Changes

- **2026-10-08** `04df18172f4d`: 3 info
  - added the new optional request property `retention_days`
  - added the optional property `expires_at` to the response with the `200` status
  - added the optional property `file_id` to the response with the `200` status
- **2026-04-13** `85a4ba66dad1`: 1 breaking, 1 info
  - the `file` request property contentMediaType changed from `` to `application/octet-stream`
  - the `file` request property format was generalized from `binary` to no format
- **2026-04-13** `5c0ca63adfe4`: 2 breaking
  - the `file` request property contentMediaType changed from `application/octet-stream` to ``
  - the `file` request property format changed from no format to `binary`
- **2026-04-13** `85a4ba66dad1`: 1 breaking, 1 info
  - the `file` request property contentMediaType changed from `` to `application/octet-stream`
  - the `file` request property format was generalized from `binary` to no format

---

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