---
title: "Changes to Get a file"
method: GET
path: "/api/files/{file_id}/"
---

# Changes to Get a file

`GET /api/files/{file_id}/`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 19 revisions.

- **2026-10-21** `c30bcb383ee8`: 3 breaking, 6 info
- **2026-10-02** `b830b79cfd52`: 1 breaking, 3 warning, 6 info
- **2026-09-17** `6fa8242da8c2`: 1 warning, 1 info
- **2026-09-12** `22b868ef3f22`: 1 info
- **2026-08-13** `4e064cf81dae`: 1 breaking, 10 info
- **2026-07-31** `c26d550029f8`: 2 breaking, 6 warning, 2 info

## Changes

- **2026-10-21** `c30bcb383ee8`: 3 breaking, 6 info
  - the response property `error/code` became nullable for the status `401`
  - the response property `error/param` became nullable for the status `401`
  - the response property `status_details` became nullable for the status `200`
  - api operation id `openAiBatch_retrieveFile` removed and replaced with `retrieveFile`
  - api tag `OpenAI Batch` added
  - api tag `openAiBatch` removed
  - removed `subschema #1, subschema #2` from the `error/code` response property `oneOf` list for the response status `401`
  - removed `subschema #1, subschema #2` from the `error/param` response property `oneOf` list for the response status `401`
  - removed `subschema #1, subschema #2` from the `status_details` response property `oneOf` list for the response status `200`
- **2026-10-02** `b830b79cfd52`: 1 breaking, 3 warning, 6 info
  - the `error` response's property type changed from `string` to `object` for status `401`
  - removed the optional property `detail` from the response with the `401` status
  - removed the optional property `error_class` from the response with the `401` status
  - removed the optional property `id` from the response with the `401` status
  - added the non-success response with the status `403`
  - added the optional property `error/code` to the response with the `401` status
  - added the optional property `error/param` to the response with the `401` status
  - the response property `error` became required for the status `401`
  - added the required property `error/message` to the response with the `401` status
  - added the required property `error/type` to the response with the `401` status
- **2026-09-17** `6fa8242da8c2`: 1 warning, 1 info
  - deleted the `header` request parameter `Authorization`
  - the endpoint scheme security `RespanApiKey` was added to the API
- **2026-09-12** `22b868ef3f22`: 1 info
  - api operation id `retrieve-file` removed and replaced with `openAiBatch_retrieveFile`
- **2026-08-13** `4e064cf81dae`: 1 breaking, 10 info
  - added the new required `query` request parameter `provider_id`
  - added the non-success response with the status `401`
  - added the non-success response with the status `404`
  - added the optional property `bytes` to the response with the `200` status
  - added the optional property `created_at` to the response with the `200` status
  - added the optional property `filename` to the response with the `200` status
  - added the optional property `purpose` to the response with the `200` status
  - added the optional property `status` to the response with the `200` status
  - added the optional property `status_details` to the response with the `200` status
  - added the required property `id` to the response with the `200` status
  - added the required property `object` to the response with the `200` status
- **2026-07-31** `c26d550029f8`: 2 breaking, 6 warning, 2 info
  - removed the required property `id` from the response with the `200` status
  - removed the required property `object` from the response with the `200` status
  - removed the optional property `bytes` from the response with the `200` status
  - removed the optional property `created_at` from the response with the `200` status
  - removed the optional property `filename` from the response with the `200` status
  - removed the optional property `purpose` from the response with the `200` status
  - removed the optional property `status` from the response with the `200` status
  - removed the optional property `status_details` from the response with the `200` status
  - removed the non-success response with the status `401`
  - removed the non-success response with the status `404`

---

[Operation](https://skmtc.dev/keywordsai/apis/respan-api/docs/api/files/:file_id/get.md) - [API](https://skmtc.dev/keywordsai/apis/respan-api.md) - [Page](https://skmtc.dev/keywordsai/apis/respan-api/changes/api/files/:file_id/get)