---
title: "Changes to Creates a new file entity by uploading data from a local machine. Uploaded files can, for example, be used for training or evaluating fine-tuned models."
method: POST
path: "/files"
---

# Changes to Creates a new file entity by uploading data from a local machine. Uploaded files can, for example, be used for training or evaluating fine-tuned models.

`POST /files`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 2 of 26 revisions.

- **2026-07-13** (2022-03-01-preview) `b177dc430e39` — 1 breaking, 2 info
- **2022-07-22** (2022-03-01-preview) `9d525b5caa31` — 3 breaking

## Changes

- **2026-07-13** (2022-03-01-preview) `b177dc430e39` — 1 breaking, 2 info
  - added required request body
  - added the media type `application/json` for the response with the status `201`
  - added the media type `application/json` for the response with the status `default`
- **2022-07-22** (2022-03-01-preview) `9d525b5caa31` — 3 breaking
  - removed the request body
  - removed the media type `application/json` for the response with the status `201`
  - removed the media type `application/json` for the response with the status `default`

---

[Operation](https://skmtc.dev/azure/apis/cognitiveservices-azureopenai-authoring/docs/files/post.md) · [API](https://skmtc.dev/azure/apis/cognitiveservices-azureopenai-authoring.md) · [Page](https://skmtc.dev/azure/apis/cognitiveservices-azureopenai-authoring/changes/files/post)