> ## Documentation Index
> Fetch the complete documentation index at: https://io-migration.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

A `Document` in R2R is the system’s digital representation of any piece of content you ingest, like a PDF report, webpage text, image, or audio file. It acts as the central container for downstream Chunks, Entities, and more.

Key processes associated with a `Document` include:

* **Ingestion**: Content is accepted from various formats (`.pdf`, `.docx`, `.txt`, `.png`, `.mp3`, etc.) via file upload, raw text, or pre-defined chunks.
* **Chunking**: The document’s content is broken down into smaller, searchable `Chunks`.
* **Metadata & Collections**: Documents are associated with descriptive `metadata` (e.g., title, source) and organized into `Collections` for access control.
* **Enrichment (Optional)**: The system can extract `Entities` and `Relationships` for knowledge graphs or generate embeddings for semantic search.
* **Status Tracking**: Ingestion and enrichment processes are monitored.

Essentially, the `Document` object is R2R’s foundational unit for turning your raw information into searchable, analyzable knowledge for RAG and agentic workflows.

## Core Document Endpoints

This section provides a high-level overview. See the detailed endpoint documentation below for request/response schemas and examples.

| Method | Endpoint | Description |
| - | - | - |
| `POST` | [/documents](https://io-migration.mintlify.site/reference/list-all-documents.md) | Ingest new information (file, text, or chunks) as a document. ([r2r-docs.sciphi.ai](https://r2r-docs.sciphi.ai/api-and-sdks/documents/documents?utm_source=chatgpt.com)) |
| `GET` | [/documents](https://io-migration.mintlify.site/reference/upload-and-ingest-a-document.md) | List existing documents with pagination and filtering. |
| `GET` | [/documents/\{id}](https://io-migration.mintlify.site/reference/get-document-by-id.md) | Retrieve details (metadata, status) about a specific document. |
| `GET` | [/documents/\{id}/download](https://io-migration.mintlify.site/reference/download-original-file.md) | Download the original source file of a document. |
| `GET` | [/documents/\{id}/chunks](https://io-migration.mintlify.site/reference/get-document-chunks.md) | List the text *Chunks* derived from a document’s content. |
| `PATCH` | [/documents/\{id}/metadata](https://io-migration.mintlify.site/reference/update-document-metadata-partial.md) | Add or update metadata for a document. |
| `PUT` | [/documents/\{id}/metadata](https://io-migration.mintlify.site/reference/replace-document-metadata.md) | Replace all metadata for a document. |
| `DELETE` | [/documents/\{id}](https://io-migration.mintlify.site/reference/delete-document-by-id.md) | Delete a specific document and its associated data. |
| `DELETE` | [/documents/by-filter](https://io-migration.mintlify.site/reference/delete-documents-by-filter.md) | Delete multiple documents matching filter criteria. |
| `POST` | [/documents/search](https://io-migration.mintlify.site/reference/search-documents.md) | Search across generated document summaries. |
| `GET` | [/documents/download\_zip](https://io-migration.mintlify.site/reference/download-documents-as-zip.md) | Download multiple original document files as a zip archive. |
| `POST` | [/documents/\{id}/extract](https://io-migration.mintlify.site/reference/extract-entities.md) | Start knowledge graph entity/relationship extraction for a document. |
| `GET` | [/documents/\{id}/entities](https://io-migration.mintlify.site/reference/get-extracted-entities.md) | List *Entities* identified within a document. |
| `GET` | [/documents/\{id}/relationship](https://io-migration.mintlify.site/reference/get-relationships.md) | List *Relationships* identified within a document. |
| `POST` | [/documents/\{id}/deduplicate](https://io-migration.mintlify.site/reference/deduplicate-document.md) | Start entity deduplication process for a document. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.