> ## 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.

# File management

> Upload and manage files for use with the file connector.

The Files API lets you upload documents and videos directly to the Data Ingestion service. Once uploaded, files can be referenced by ID in job submissions using the [file connector](/data-ingestion/connectors/file-upload).

## Endpoints

<CardGroup cols={2}>
  <Card title="Upload files" icon="upload" href="/data-ingestion/files/upload">
    Upload documents or videos to managed storage
  </Card>

  <Card title="List files" icon="list" href="/data-ingestion/files/list">
    View your uploaded files and their metadata
  </Card>
</CardGroup>

## Required permissions

| Endpoint     | Permission                |
| ------------ | ------------------------- |
| Upload files | `file:upload` or `file:*` |
| List files   | `file:list` or `file:*`   |