> ## 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 `Collection` in R2R is a logical grouping mechanism that enables organization and access control for documents and their associated chunks. Collections serve as a fundamental unit for managing permissions, sharing content, and organizing related documents across users and teams.

Collections in R2R provide:

* Organizational structure for documents
* Access control and permissions management
* Group-based content sharing
* Document categorization and management
* User collaboration capabilities

## Available Endpoints

| Method | Endpoint | Description |
| - | - | - |
| POST | [/collections](https://io-migration.mintlify.site/reference/create-a-new-collection.md) | Create a new collection |
| GET | [/collections](https://io-migration.mintlify.site/reference/list-collections.md) | List collections with pagination and filtering |
| GET | [/collections/\{id}](https://io-migration.mintlify.site/reference/get-collection-by-id.md) | Get details of a specific collection |
| POST | [/collections/\{id}](https://io-migration.mintlify.site/reference/update-collection.md) | Update an existing collection |
| DELETE | [/collections/\{id}](https://io-migration.mintlify.site/reference/delete-collection.md) | Delete a specific collection |
| GET | [/collections/\{id}/documents](https://io-migration.mintlify.site/reference/list-documents-in-collection.md) | List documents in a collection |
| POST | [/collections/\{id}/documents/\{document\_id}](https://io-migration.mintlify.site/reference/add-document-to-collection.md) | Add a document to a collection |
| DELETE | [/collections/\{id}/documents/\{document\_id}](https://io-migration.mintlify.site/reference/remove-document-from-collection.md) | Remove a document from a collection |
| POST | [/collections/\{id}/extract](https://io-migration.mintlify.site/reference/trigger-extraction-for-a-collection.md) | Extract entities and relationships for all unprocessed documents |
| GET | [/collections/\{id}/users](https://io-migration.mintlify.site/reference/list-users-in-a-collection.md) | List users with access to a collection |
| POST | [/collections/\{id}/users/\{user\_id}](https://io-migration.mintlify.site/reference/add-user-to-collection.md) | Add a user to a collection |
| DELETE | [/collections/\{id}/users/\{user\_id}](https://io-migration.mintlify.site/reference/remove-user-from-collection.md) | Remove a user from a collection |
| GET | [/collections/name/\{collection\_name}](https://io-migration.mintlify.site/reference/get-collection-by-name.md) | Get collection by name |


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