---
title: "Changes to List files"
method: GET
path: "/files"
---

# Changes to List files

`GET /files`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 10 of 397 revisions.

- **2026-10-06** `e2f8d8cbc41f`: 3 info
- **2026-10-06** `7eddcd50e394`: 1 breaking
- **2026-09-25** `cda988e2e364`: 3 info
- **2026-05-13** `74cbcf73838f`: 1 warning
- **2026-04-10** `7c540cce6eb3`: 1 warning
- **2025-03-11** `6ab43fe7798e`: 1 info
- **2024-11-04** `681d8ec16477`: 7 info
- **2024-11-04** `2f8ca92b9b18`: 7 info
- **2024-05-09** `084b8f68408c`: 1 warning
- **2024-05-08** `2e14236d4015`: 2 warning

## Changes

- **2026-10-06** `e2f8d8cbc41f`: 3 info
  - added the optional property `error/misalignment/review_target` to the response with the `400` status
  - added the optional property `error/misalignment/review_target` to the response with the `404` status
  - added the optional property `error/misalignment/review_target` to the response with the `429` status
- **2026-10-06** `7eddcd50e394`: 1 breaking
  - the response property `data/items/bytes` became nullable for the status `200`
- **2026-09-25** `cda988e2e364`: 3 info
  - added the non-success response with the status `400`
  - added the non-success response with the status `404`
  - added the non-success response with the status `429`
- **2026-05-13** `74cbcf73838f`: 1 warning
  - added the new `user_data` enum value to the `data/items/purpose` response property for the response status `200`
- **2026-04-10** `7c540cce6eb3`: 1 warning
  - added the new `user_data` enum value to the `data/items/purpose` response property for the response status `200`
- **2025-03-11** `6ab43fe7798e`: 1 info
  - added the optional property `data/items/expires_at` to the response with the `200` status
- **2024-11-04** `681d8ec16477`: 7 info
  - added the new optional `query` request parameter `after`
  - added the new optional `query` request parameter `limit`
  - added the new optional `query` request parameter `order`
  - removed the `list` enum value from the `object` response property for the response status `200`
  - added the required property `first_id` to the response with the `200` status
  - added the required property `has_more` to the response with the `200` status
  - added the required property `last_id` to the response with the `200` status
- **2024-11-04** `2f8ca92b9b18`: 7 info
  - added the new optional `query` request parameter `after`
  - added the new optional `query` request parameter `limit`
  - added the new optional `query` request parameter `order`
  - removed the `list` enum value from the `object` response property for the response status `200`
  - added the required property `first_id` to the response with the `200` status
  - added the required property `has_more` to the response with the `200` status
  - added the required property `last_id` to the response with the `200` status
- **2024-05-09** `084b8f68408c`: 1 warning
  - added the new `vision` enum value to the `data/items/purpose` response property for the response status `200`
- **2024-05-08** `2e14236d4015`: 2 warning
  - added the new `batch` enum value to the `data/items/purpose` response property for the response status `200`
  - added the new `batch_output` enum value to the `data/items/purpose` response property for the response status `200`

---

[Operation](https://skmtc.dev/openai/apis/openapi/docs/files/get.md) - [API](https://skmtc.dev/openai/apis/openapi.md) - [Page](https://skmtc.dev/openai/apis/openapi/changes/files/get)