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

# Knowledge

> Import Coda documents and pages into Ravenna knowledge folders, preserving page hierarchy and converting tables to text for AI-powered answers.

Import Coda documents to power agent responses. Connect entire docs with preserved page hierarchy, table data conversion, and intelligent sync that captures new pages and updates.

## What you can do

* Import entire Coda documents by Doc ID
* Preserve original page structure and hierarchy
* Convert tables and structured data to readable text
* Auto-sync new pages, edits, and hierarchy changes

## Setup

<Steps>
  <Step title="Select Coda as your source">
    When adding documents to a knowledge folder, select **Coda** from the available sources.
  </Step>

  <Step title="Provide credentials">
    Enter your Coda connection details:

    * **Doc ID**: The unique identifier for your Coda document (found in the URL after `_d`)
    * **API Token**: Your Coda API token for authentication (generate in Coda account settings)
  </Step>

  <Step title="Import content">
    All pages from your specified Coda document are imported.
  </Step>
</Steps>

<Callout icon="link" color="#6B7280">Learn more about [managing knowledge folders](/documentation/automate/knowledge/overview)</Callout>

## How it works

<AccordionGroup>
  <Accordion title="Finding your Doc ID" icon="file">
    Your Coda Doc ID can be found in the document URL:

    1. Open your Coda document.
    2. Look at the URL in your browser.
    3. The Doc ID is the alphanumeric string after `_d` in the URL.
    4. Example: In `https://coda.io/d/_dAbCdEfGhI/My-Doc`, the Doc ID is `AbCdEfGhI` (without the `_d` prefix).
  </Accordion>

  <Accordion title="Generating an API token" icon="key">
    To create a Coda API token:

    1. Go to your [Coda account settings](https://coda.io/account).
    2. Navigate to the **API Settings** section.
    3. Click **Generate API Token**.
    4. Copy the token and paste it into Ravenna.

    <Warning>Keep your API token secure. Anyone with this token can access your Coda documents.</Warning>
  </Accordion>

  <Accordion title="What gets imported" icon="package">
    When you connect a Coda document:

    * All pages within the document are imported.
    * Sub-pages and nested content are included.
    * Page hierarchy is preserved.
    * Tables and structured data are converted to readable text.
  </Accordion>

  <Accordion title="Hierarchy preservation" icon="folder-tree">
    Original page structure from your Coda document is maintained:

    * Parent-child relationships between pages are preserved.
    * Page organization mirrors your Coda document.
    * Nested pages are automatically imported.
    * Updates to page hierarchy in Coda sync during auto-sync.
  </Accordion>
</AccordionGroup>

## Managing imported content

After import:

* Remove unwanted pages from your knowledge folder.
* Archive specific pages to exclude them from agent responses.
* Removed or archived pages are automatically skipped during future syncs.

<Callout icon="link" color="#6B7280">Learn more about [managing documents](/documentation/automate/knowledge/overview#managing-documents)</Callout>

## Auto-sync

When auto-sync is enabled, Coda content stays up-to-date:

* New pages added to the document are automatically imported.
* Page edits and updates sync to your knowledge base.
* Deleted pages are removed from your knowledge base.
* Page reorganization is reflected in the hierarchy.