Create File | extend

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

Authentication

Headers

Request

Response

Errors