> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trelent.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Data Ingestion

> Trelent's Data Ingestion API turns files into LLM-ready Markdown.

Trelent's Data Ingestion API turns files into LLM-ready Markdown. It can be used with the following file formats:

| Category   | Supported File Types                                                        |
| ---------- | --------------------------------------------------------------------------- |
| **Office** | DOCX, DOC, DOTX, DOTM, DOCM, PPTX, POTX, PPSX, PPTM, POTM, PPSM, XLSX, XLSM |
| **PDF**    | PDF                                                                         |
| **Markup** | MD, HTML, HTM, XHTML, XML, NXML                                             |
| **Data**   | CSV, TXT, VTT                                                               |
| **Images** | JPG, JPEG, PNG, TIF, TIFF, BMP, WEBP                                        |
| **Video**  | MP4, AVI, MOV, WMV, MKV, FLV, WEBM, M4V                                     |

## How the API works

Each job has two parts:

1. **Connector** - where your files come from (S3 or URLs)
2. **Output** - where results are delivered (S3 or temporary URLs)

<Columns cols={2}>
  <Card title="Connectors" icon="plug" href="/data-ingestion/connectors/index" arrow="true" cta="View Connectors">
    Describe the source of one or more files that the API will ingest.
  </Card>

  <Card title="Outputs" icon="arrow-up-from-bracket" href="/data-ingestion/outputs/index" arrow="true" cta="View Outputs">
    Choose how results are delivered (your S3 bucket or time-limited links).
  </Card>
</Columns>

## Installation

<Tabs>
  <Tab title="TypeScript">
    <CodeGroup>
      ```bash bun theme={null}
      bun add @trelent/data-ingestion
      ```

      ```bash npm theme={null}
      npm install @trelent/data-ingestion
      ```

      ```bash yarn theme={null}
      yarn add @trelent/data-ingestion
      ```

      ```bash pnpm theme={null}
      pnpm add @trelent/data-ingestion
      ```
    </CodeGroup>
  </Tab>

  <Tab title="Python">
    <CodeGroup>
      ```bash pip theme={null}
      pip install trelent-data-ingestion
      ```

      ```bash uv theme={null}
      uv add trelent-data-ingestion
      ```
    </CodeGroup>
  </Tab>
</Tabs>

## Quickstart

<Card title="Quickstart" icon="rocket" href="/data-ingestion/quickstart" arrow="true" cta="Get Started">
  Upload a file, submit a job, and retrieve results in three steps.
</Card>

## File uploads

Upload files directly to the API instead of hosting them in S3 or exposing URLs. Uploaded files can be referenced across multiple jobs.

<Card title="File management" icon="file-arrow-up" href="/data-ingestion/files/index" arrow="true" cta="Manage Files">
  Upload, list, and manage files for processing.
</Card>

## Admin

<Warning>
  These features are for **administrators and platform operators** only. Most users receive a pre-configured token and do not need these APIs.
</Warning>

<Card title="Token management" icon="key" href="/data-ingestion/tokens/index" arrow="true" cta="Manage Tokens">
  Generate, list, and revoke API access tokens with scoped permissions.
</Card>