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, 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](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).

Authentication

AuthorizationBearer

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

Request

This endpoint expects a multipart form containing a file.

filefileRequired

The file contents to upload

Response

Successfully uploaded file

successboolean

fileobject

1	import { ExtendClient } from "extend-ai";
2
3	async function main() {
4	const client = new ExtendClient({
5	token: "YOUR_TOKEN_HERE",
6	});
7	await client.files.upload();
8	}
9	main();

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	}

Authentication

Headers

Request

Response

Errors