Upload File

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](https://docs.extend.ai/2025-04-21/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).

Authentication

AuthorizationBearer

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

Query parameters

convertToPdfbooleanOptionalDefaults to false

When true, converts the uploaded file to PDF. Supported file types include images (JPEG, PNG, TIFF, GIF, BMP, WebP, HEIC/HEIF), Word documents, PowerPoint, Excel, and HTML.

Request

This endpoint expects a multipart form containing a file.

filefileRequired

The file contents to upload

Response

Successfully uploaded file

successboolean

fileobject

Errors

400

Bad Request Error

401

Unauthorized Error

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 for more details.

The workspace ID to target. Required when using an organization-scoped API key; optional for workspace-scoped keys (the key is already tied to a workspace). See Authentication for details on API key scopes.

When true, converts the uploaded file to PDF. Supported file types include images (JPEG, PNG, TIFF, GIF, BMP, WebP, HEIC/HEIF), Word documents, PowerPoint, Excel, and HTML.

This endpoint expects a multipart form containing a file.

The file contents to upload

Successfully uploaded file

1	from extend_ai import Extend
2
3	client = Extend(
4	token="YOUR_TOKEN_HERE",
5	extend_api_version="2025-04-21",
6	)
7
8	client.files.upload(
9	file="example_file",
10	)

1	{
2	"success": true,
3	"file": {
4	"object": "file",
5	"id": "file_dmuFrLrcdW0Jv6f78f20a",
6	"name": "My File",
7	"metadata": {},
8	"createdAt": "2025-05-12T20:57:39.105000+00:00",
9	"updatedAt": "2025-05-12T20:57:39.111000+00:00",
10	"type": "PDF",
11	"contents": {}
12	}
13	}

1	from extend_ai import Extend
2
3	client = Extend(
4	token="YOUR_TOKEN_HERE",
5	extend_api_version="2025-04-21",
6	)
7
8	client.files.upload(
9	file="example_file",
10	)

1	{
2	"success": true,
3	"file": {
4	"object": "file",
5	"id": "file_dmuFrLrcdW0Jv6f78f20a",
6	"name": "My File",
7	"metadata": {},
8	"createdAt": "2025-05-12T20:57:39.105000+00:00",
9	"updatedAt": "2025-05-12T20:57:39.111000+00:00",
10	"type": "PDF",
11	"contents": {}
12	}
13	}

Upload File

Authentication

Headers

Query parameters

Request

Response

Errors

Authentication

Headers

Query parameters

Request

Response

Errors