Create File

curl -X POST https://api.extend.ai/files \
     -H "x-extend-api-version: 2025-04-21" \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "string"
}'

{
  "success": true,
  "file": {
    "object": "file",
    "id": "file_xK9mLPqRtN3vS8wF5hB2cQ",
    "name": "Invoices.pdf",
    "metadata": {
      "pageCount": 30,
      "parentSplit": {
        "id": "string",
        "type": "Invoice",
        "identifier": "other_2_9",
        "startPage": 1,
        "endPage": 10
      }
    },
    "createdAt": "2024-03-21T15:30:00Z",
    "updatedAt": "2024-03-21T16:45:00Z",
    "type": "PDF",
    "presignedUrl": "https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf",
    "parentFileId": "file_Zk9mNP12Qw4yTv8BdR3H",
    "contents": {
      "rawText": "string",
      "markdown": "string",
      "pages": [
        {
          "pageNumber": 1,
          "pageHeight": 10,
          "pageWidth": 10,
          "rawText": "This is the raw text of the page.",
          "markdown": "# Heading\n\nThis is a paragraph with **bold** and *italic* text.\n\n- List item 1\n- List item 2\n\n> This is a blockquote",
          "html": "<div>This is the html of the page.</div>"
        }
      ],
      "sheets": [
        {
          "sheetName": "Sheet1",
          "rawText": "This is the raw text of the sheet."
        }
      ]
    },
    "usage": {
      "credits": 10
    }
  }
}

curl -X POST https://api.extend.ai/files \
     -H "x-extend-api-version: 2025-04-21" \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "string"
}'

{
  "success": true,
  "file": {
    "object": "file",
    "id": "file_xK9mLPqRtN3vS8wF5hB2cQ",
    "name": "Invoices.pdf",
    "metadata": {
      "pageCount": 30,
      "parentSplit": {
        "id": "string",
        "type": "Invoice",
        "identifier": "other_2_9",
        "startPage": 1,
        "endPage": 10
      }
    },
    "createdAt": "2024-03-21T15:30:00Z",
    "updatedAt": "2024-03-21T16:45:00Z",
    "type": "PDF",
    "presignedUrl": "https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf",
    "parentFileId": "file_Zk9mNP12Qw4yTv8BdR3H",
    "contents": {
      "rawText": "string",
      "markdown": "string",
      "pages": [
        {
          "pageNumber": 1,
          "pageHeight": 10,
          "pageWidth": 10,
          "rawText": "This is the raw text of the page.",
          "markdown": "# Heading\n\nThis is a paragraph with **bold** and *italic* text.\n\n- List item 1\n- List item 2\n\n> This is a blockquote",
          "html": "<div>This is the html of the page.</div>"
        }
      ],
      "sheets": [
        {
          "sheetName": "Sheet1",
          "rawText": "This is the raw text of the sheet."
        }
      ]
    },
    "usage": {
      "credits": 10
    }
  }
}

Create a new file in Extend for use in an evaluation set. This endpoint is deprecated, use /files/upload instead.

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.

namestringRequired

The name of the file

urlstringOptional

A pre signed URL for the file

rawTextstringOptional

The raw text content of the file

mediaTypestringOptional

The media type of the file (e.g. application/pdf)

Response

Successfully created file

successboolean

fileobject

Errors

400

Bad Request Error

401

Unauthorized Error

Create File

Authentication

Headers

Request

Response

Errors

Authentication

Headers

Request

Response

Errors

$	curl -X POST https://api.extend.ai/files \
>	-H "x-extend-api-version: 2025-04-21" \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"name": "string"
>	}'

1	{
2	"success": true,
3	"file": {
4	"object": "file",
5	"id": "file_xK9mLPqRtN3vS8wF5hB2cQ",
6	"name": "Invoices.pdf",
7	"metadata": {
8	"pageCount": 30,
9	"parentSplit": {
10	"id": "string",
11	"type": "Invoice",
12	"identifier": "other_2_9",
13	"startPage": 1,
14	"endPage": 10
15	}
16	},
17	"createdAt": "2024-03-21T15:30:00Z",
18	"updatedAt": "2024-03-21T16:45:00Z",
19	"type": "PDF",
20	"presignedUrl": "https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf",
21	"parentFileId": "file_Zk9mNP12Qw4yTv8BdR3H",
22	"contents": {
23	"rawText": "string",
24	"markdown": "string",
25	"pages": [
26	{
27	"pageNumber": 1,
28	"pageHeight": 10,
29	"pageWidth": 10,
30	"rawText": "This is the raw text of the page.",
31	"markdown": "# Heading\n\nThis is a paragraph with bold and italic text.\n\n- List item 1\n- List item 2\n\n> This is a blockquote",
32	"html": "<div>This is the html of the page.</div>"
33	}
34	],
35	"sheets": [
36	{
37	"sheetName": "Sheet1",
38	"rawText": "This is the raw text of the sheet."
39	}
40	]
41	},
42	"usage": {
43	"credits": 10
44	}
45	}
46	}