---
title: "Changes to Update file metadata or replace its file"
method: PATCH
path: "/api/v3/files/{id}"
---

# Changes to Update file metadata or replace its file

`PATCH /api/v3/files/{id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 2 revisions.

- **2026-11-03** `63ecbc61b6a9`: 1 breaking, 11 info

## Changes

- **2026-11-03** `63ecbc61b6a9`: 1 breaking, 11 info
  - added `#/components/schemas/ExternalMetadataResponse, subschema #2` to the `external_metadata` response property `oneOf` list for the response status `200`
  - added the new optional request property `file` (media type: multipart/form-data)
  - added the new optional request property `file` (media type: application/x-www-form-urlencoded)
  - added the media type `application/json` for the response with the status `400`
  - added the media type `application/json` for the response with the status `401`
  - added the media type `application/json` for the response with the status `404`
  - added the non-success response with the status `403`
  - added the non-success response with the status `422`
  - added the non-success response with the status `503`
  - removed `#/components/schemas/ExternalMetadataResponse` from the `external_metadata` response property `allOf` list for the response status `200`
  - added the required property `pending_reprocess` to the response with the `200` status
  - added the required property `thumbnail` to the response with the `200` status

---

[Operation](https://skmtc.dev/lighton/apis/lighton-api/docs/api/v3/files/:id/patch.md) - [API](https://skmtc.dev/lighton/apis/lighton-api.md) - [Page](https://skmtc.dev/lighton/apis/lighton-api/changes/api/v3/files/:id/patch)