// customize
const inkeepSettings = {
    isOpen: true,
    baseSettings: {
        apiKey: '3adc15f45617826bb73c0a4cb9fb3a06547b6ab7f90c819e',
        integrationId: 'clv1yuc8f0002vzhxbzwy26yx',
        organizationId: 'clu6yudh9000sajgn7nwxfve8',
        primaryBrandColor: '#26D6FF', // your brand color, widget color scheme is derived from this
        organizationDisplayName: 'R2R',
        theme: {
          colorMode: {
            forcedColorMode: 'dark', // to sync dark mode with the widget
          },
        },
    },
    aiChatSettings: {
      // ...optional settings
      botAvatarSrcUrl:
        "https://www.sciphi.ai/screenshots/logo222_cut.png",
      quickQuestions: [
        "How do I get started?",
        "How does R2R implement hybrid search?",
        "How do I use the R2R API?",
        // "How do I use ",
        // "Example question 3?",
      ],
    },
    modalSettings: {
      isShortcutKeyEnabled: false, // disable default cmd+k behavior
      // ...optional settings
    },
  };

  // The Mintlify search triggers, which we'll reuse to trigger the Inkeep modal
  const searchButtonContainerIds = [
    "search-bar-entry",
    "search-bar-entry-mobile",
  ];

  // Clone and replace, needed to remove existing event listeners
  const clonedSearchButtonContainers = searchButtonContainerIds.map((id) => {
    const originalElement = document.getElementById(id);
    const clonedElement = originalElement.cloneNode(true);
    originalElement.parentNode.replaceChild(clonedElement, originalElement);

    return clonedElement;
  });

  // Load the Inkeep component library
  const inkeepScript = document.createElement("script");
  inkeepScript.type = "module";
  inkeepScript.src =
    "https://unpkg.com/@inkeep/widgets-embed@latest/dist/embed.js";
  document.body.appendChild(inkeepScript);

  // Once the Inkeep library is loaded, instantiate the UI components
  inkeepScript.addEventListener("load", function () {
    // Customization settings

    // for syncing with dark mode
    const colorModeSettings = {
      observedElement: document.documentElement,
      isDarkModeCallback: (el) => {
        return el.classList.contains("dark");
      },
      colorModeAttribute: "class",
    };

    // Instantiate the "Ask AI" pill chat button
    Inkeep().embed({
      componentType: "ChatButton",
      colorModeSync: colorModeSettings,
      properties: inkeepSettings,
    });

    // Instantiate the search bar modal
    const inkeepSearchModal = Inkeep({
      ...inkeepSettings.baseSettings,
    }).embed({
      componentType: "CustomTrigger",
      colorModeSync: colorModeSettings,
      properties: {
        ...inkeepSettings,
        isOpen: false,
        onClose: () => {
          inkeepSearchModal.render({
            isOpen: false,
          });
        },
      },
    });

    // When the Mintlify search bar elements are clicked, open the Inkeep search modal
    clonedSearchButtonContainers.forEach((trigger) => {
      trigger.addEventListener("click", function () {
        inkeepSearchModal.render({
          isOpen: true,
        });
      });
    });

    // Open the Inkeep Modal with cmd+k
    window.addEventListener(
      "keydown",
      (event) => {
        if (
          (event.metaKey || event.ctrlKey) &&
          (event.key === "k" || event.key === "K")
        ) {
          event.stopPropagation();
          inkeepSearchModal.render({ isOpen: true });
          return false;
        }
      },
      true
    );
  });


Community

Build, scale, and manage user-facing Retrieval-Augmented Generation applications.

Introduction

Documentation

API Reference

Cookbooks

R2R GitHub

Support

Ingest Chunks

The ID of the document that was ingested.

Document Id

A message describing the result of the ingestion request.

Message

Task Id

IngestionResponse

Text

RawChunk

Location

Error Type

ValidationError

Ingest text chunks into the system.

This endpoint supports multipart/form-data requests, enabling you to ingest pre-parsed text chunks into R2R.

A valid user authentication token is required to access this endpoint, as regular users can only ingest chunks for their own access. More expansive collection permissioning is under development.

Body_ingest_chunks_app_v2_ingest_chunks_post

HTTPBearer

ResultsWrapper[list[IngestionResponse]]

HTTPValidationError

Ingest Chunks App

System

What's New

Quickstart

Key terms and environment settings for R2R

Glossary

Learn how to configure your R2R deployment

Postgres

Learn how to configure LLMs in your R2R deployment

LLMs

Learn how to configure RAG in your R2R deployment

Learn how to configure and manage prompts in your R2R deployment

Prompts

Overview

Embedding

Configure your R2R knowledge graph provider.

Configuration for Restructuring data after ingestion using Knowledge Graphs

KG Enrichment

Vector Search

Knowledge Graph

Learn how to run a Retrieval-Augmented Generation system locally using R2R

Local LLMs

Azure

Learn how to deploy R2R into Google Cloud

SciPhi Enterprise

Core Logic

R2RConfig

R2RBuilder

Learn how to configure and use the authentication provider in R2R

Crypto & Auth

Configure and use multiple Language Model providers in R2R

Language Models (LLMs)

Learn how to configure and use the database provider in R2R

Database

Learn how to configure and use the knowledge graph provider in R2R

Learn about R2R telemetry and how to manage it

Telemetry

Powerful document ingestion, search, and RAG capabilities at your fingertips

R2R API Reference

Ingest Files

Update Files

Create Vector Index

Create Graph

Enrich Graph

Entities

Triples

Communities

Search

Agent

Document Chunks

Delete

Documents Overview

Register

Verify Email

Login

Get User

Update User

Delete User

Refresh Access Token

Logout

Change Password

Password Reset

Create Collection

Get Collection

Update Collection

Delete Collection

List Collections

Add User to Collection

Remove User from Collection

Get Users in Collection

Get Collections for User

Collections Overview

Assign Document to Collection

Remove Document from Collection

Get Document Collections

Update Prompt

Add Prompt

Get Prompt

Get All Prompts

Delete Prompt

Logs

Users Overview

App Settings

Analytics

Health

A detailed step-by-step cookbook of the core features provided by R2R.

Walkthrough

Learn how to ingest, update, and delete documents with R2R

Ingestion Cookbook

Learn how to implement and use hybrid search with R2R

Hybrid Search

Learn how to build and use GraphRAG with R2R

GraphRAG

Learn how to build and use advanced RAG techniques with R2R

Advanced RAG

Learn how to implement and use agents with R2R

Agents

Learn how orchestration is handled inside R2R

Orchestration

Learn how to build webapps powered by RAG using R2R

Web Development

A comprehensive guide to user authentication and management features in R2R

User Auth

A comprehensive guide to creating collections in R2R

Collections

Learn how to use analytics and and logging with R2R

Analytics & Observability

Learn how to set up and use the R2R Application for managing your instance.

Application

Learn how to deploy R2R into remote cloud environments

API Documentation

Document Ingestion

Knowledge Graph

Retrieval

User Documents

User Auth

Collections

Admin

Analytics and Observability

Status

Ingest Chunks

Authorizations

Body

Response