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

# Introduction

> Understand document uploads, supported formats, and the document lifecycle in Ingestly.

A **document** is a file uploaded to a pipeline for processing. Each document goes through a lifecycle as it moves through the pipeline.

## Supported formats

<Snippet file="supported-file-types.mdx" />

## Upload methods

You can upload documents to a pipeline in several ways:

| Method       | Description                                                              |
| ------------ | ------------------------------------------------------------------------ |
| **Upload**   | Drag and drop documents or click to browse from the pipeline detail page |
| **Email**    | Forward or send documents to the pipeline's email address                |
| **HTTP API** | POST documents to the `/pipelines/{pipelineId}/trigger` endpoint         |

## Document lifecycle

Documents move through the following statuses as they are processed:

```mermaid actions={false} theme={null}
%%{init: {'flowchart': {'defaultRenderer': 'elk', 'curve': 'stepAfter'}}}%%
flowchart LR
    Start(( )) --> Pending
    Pending --> Uploaded
    Uploaded --> Processing
    Processing --> Completed
    Processing --> Failed
    Processing --> Review
    Processing --> Cancelled
    Review --> Completed
    Review --> Failed
```

| Status         | Description                                            |
| -------------- | ------------------------------------------------------ |
| **Pending**    | Document upload initiated but not yet received         |
| **Uploaded**   | Document received and queued for processing            |
| **Processing** | Pipeline is actively processing the document           |
| **Completed**  | All pipeline steps finished successfully               |
| **Failed**     | Processing encountered an error                        |
| **Review**     | Document is waiting for human review before continuing |
| **Cancelled**  | Run was cancelled before completing                    |

## Document details

Each document record includes:

* Original document name and format
* Upload timestamp and method
* Current status
* Associated run (if processing has started)
* Document size

## Managing documents

You manage documents from the [pipeline detail page](/files/managing). You can upload, preview, re-run, and delete documents.