Upload File | extend

Upload and create a new file in Extend.

This endpoint accepts file contents and registers them as a File in Extend, which can be used for running workflows, creating evaluation set items, parsing, etc.

If an uploaded file is detected as a Word or PowerPoint document, it will be automatically converted to a PDF.

Supported file types can be found here.

This endpoint requires multipart form encoding. Most HTTP clients will handle this encoding automatically (see the examples).

Upload and create a new file in Extend. This endpoint accepts file contents and registers them as a File in Extend, which can be used for [running workflows](https://docs.extend.ai/2025-04-21/developers/api-reference/workflow-endpoints/run-workflow), [creating evaluation set items](https://docs.extend.ai/2025-04-21/developers/api-reference/evaluation-set-endpoints/bulk-create-evaluation-set-items), [parsing](https://docs.extend.ai/2025-04-21/developers/api-reference/parse-endpoints/parse-file), etc. If an uploaded file is detected as a Word or PowerPoint document, it will be automatically converted to a PDF. Supported file types can be found [here](/product/general/supported-file-types). This endpoint requires multipart form encoding. Most HTTP clients will handle this encoding automatically (see the examples).

Upload and create a new file in Extend.

This endpoint accepts file contents and registers them as a File in Extend, which can be used for running workflows, creating evaluation set items, parsing, etc.

If an uploaded file is detected as a Word or PowerPoint document, it will be automatically converted to a PDF.

Supported file types can be found here.

This endpoint requires multipart form encoding. Most HTTP clients will handle this encoding automatically (see the examples).

Bearer authentication of the form `Bearer <token>`, where token is your auth token.

API version to use for the request. If you do not specify a version, you will either receive a `400 Bad Request` or be set to a previous legacy version. See [API Versioning](/developers/api-versioning) for more details.

This endpoint expects a multipart form containing a file.

The file contents to upload

Successfully uploaded file

1	curl -X POST https://api.extend.ai/files/upload \
2	-H "x-extend-api-version: " \
3	-H "Authorization: Bearer <token>" \
4	-H "Content-Type: multipart/form-data" \
5	-F file=@string

1	{
2	"success": true,
3	"file": {
4	"object": "file",
5	"id": "file_dmuFrLrcdW0Jv6f78f20a",
6	"name": "My File",
7	"metadata": {
8	"pageCount": {},
9	"parentSplit": {}
10	},
11	"createdAt": "2025-05-12T20:57:39.105000+00:00",
12	"updatedAt": "2025-05-12T20:57:39.111000+00:00",
13	"type": "PDF",
14	"presignedUrl": {},
15	"parentFileId": {},
16	"contents": {
17	"rawText": {},
18	"markdown": {},
19	"pages": {},
20	"sheets": {}
21	}
22	}
23	}

Authentication

Headers

Request

Response

Errors