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

# Overview

> The R2R Chunks API defines how processed document segments, called chunks, are created, managed, and searched. It provides endpoints for semantic retrieval, knowledge graph extraction, and metadata-driven filtering to power advanced AI and RAG workflows.

A **Chunk** in R2R represents a processed segment of content derived from a parent **Document**. Chunks are the **core unit of retrieval** within the system, serving as the foundation for **semantic search**, **knowledge graph construction**, and **Retrieval-Augmented Generation (RAG)** workflows.

Each chunk includes the following components:

* **Text content** — the extracted or generated portion of the source document.
* **Metadata** — contextual information such as source, timestamp, or author.
* **Optional vector embeddings** — numerical representations used for similarity search and reasoning.

Chunks are automatically generated during document ingestion and are optimized for:

* Semantic search and retrieval
* Knowledge graph relationship extraction
* Vector similarity comparison
* Metadata-based filtering and organization

## API Endpoints

| Method | Endpoint                                              | Description                                    |
| ------ | ----------------------------------------------------- | ---------------------------------------------- |
| GET    | [/chunks](/reference/rag/chunks/list-chunks)          | List chunks with pagination and filtering.     |
| POST   | [/chunks/search](/reference/rag/chunks/search-chunks) | Perform semantic search with advanced filters. |
| GET    | [/chunks/](/reference/rag/chunks/get-chunk-by-id)     | Retrieve a chunk by its ID.                    |
| POST   | [/chunks/](/reference/rag/chunks/update-chunk)        | Update chunk content or metadata.              |
| DELETE | [/chunks/](/reference/rag/chunks/delete-chunk)        | Delete a specific chunk.                       |
