> This page is for version v2024-12-23.
> For other versions, use one of these documentation indexes:
> - v2026-02-09 (default): https://docs.extend.ai/2026-02-09/llms.txt
> - v2025-04-21: https://docs.extend.ai/2025-04-21/llms.txt
> - v2024-12-23: https://docs.extend.ai/2024-12-23/llms.txt

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.extend.ai/llms.txt
> Use this file to discover all available pages before exploring further.
>
> ## API version
> The current API version is `2026-02-09`, served at the site root (no version prefix in URLs).
> If this page URL contains `/2025-04-21/` or `/2024-12-23/`, you are reading an older API version.
> Prefer the current docs at https://docs.extend.ai/llms.txt unless the user explicitly needs that older version.
> Do not treat older-version pages as the source of truth for new integrations.

# The File object

The File object represents a file in Extend. Files are created for each workflow run, and can also be created directly via API for use in evaluation sets.

#### properties

**`object`** `string`

The type of the object, in this case it will always be "file".

---

**`id`** `string`

The file ID.

---

**`name`** `string`

The name of the file.

---

**`type`** `string`

The Extend normalized type of the file. One of `IMG` `PDF` `TXT` `DOCX` `CSV`
`EXCEL`.

---

**`parentFileId`** `string`

The ID of the parent file. Only included if this file is a derivative of
another file, for instance if it was created via a Splitter in a workflow.

---

**`presignedUrl`** `string`

A presigned URL to download the file. Expires after 15 minutes.

---

**`contents`** `object`

#### properties

**`rawText`** `string`

The raw text content of the file. This is included for all file types if
the `rawText` query parameter is set to true in the endpoint request.

---

**`pages`** `array`

An array of page objects representing the content of each page in the
file.

#### properties

**`pageNumber`** `number`

The page number of this page in the document.

---

**`markdown`** `string`

Cleaned and structured markdown content of the page. Available for PDF
and IMG file types. Only included if the `markdown` query parameter is
set to true in the endpoint request.

---

**`html`** `string`

Cleaned and structured html content of the page. Available for DOCX
file types (that were not auto-converted to PDFs). Only included if
the `html` query parameter is set to true in the endpoint request.

---

---

---

**`metadata`** `object`

#### properties

**`pageCount`** `number`

The number of pages in the file. This is only set for PDF/DOCX files.

---

**`parentSplit`** `object`

The split metadata details. Only included if this file is a derivative of
another file, for instance if it was created via a Splitter in a workflow.

#### properties

**`id`** `string`

The ID of the split.

---

**`type`** `string`

The type of the split.

---

**`identifier`** `string`

The identifier of the split.

---

**`startPage`** `number`

The start page of the split.

---

**`endPage`** `number`

The end page of the split.

---

---

---

**`createdAt`** `string`

The date and time the file was created.

---

**`updatedAt`** `string`

The date and time the file was last updated.

---

**Note:** There are several deprecated fields that are still in the payload for backwards compatibility. These are:

* markdown/rawText in IMGs not nested under pages array. These will still be included in payloads until full deprecation in December 2024.

**`Example File`**

```json Example File
{
  "object": "file",
  "id": "file_1234",
  "name": "example_file",
  "type": "PDF",
  "presignedUrl": "https://s3.example.com/file_1234.pdf",
  "parentFileId": "file_5678", // Optional, only set if this file is a derivative of another file
  "contents": {
    "rawText": "This is the raw text content of the file...",
    "pages": [
      {
        "pageNumber": 1,
        "markdown": "This is the markdown content of the page...",
      }
    ]
  },
  "metadata": {
    "parentSplit": { // Optional, only set if this file is a derivative of another file
      "id": "324kjlfsd",
      "type": "addendum",
      "identifier": "addendum_1",
      "startPage": 7,
      "endPage": 9
    }
  },
  "createdAt": "2024-01-01T00:00:00Z",
  "updatedAt": "2024-01-01T00:00:00Z"
}
```