# Coda

Index and search Coda knowledge base

Connect your Coda workspace to Risotto to make Coda documentation searchable through the AI assistant.

## Prerequisites

Before setting up the Coda integration, ensure you have:

1. **Coda API Token** - You only need read access for the token

## Setup Process

### Step 1: Get Coda API Token

1. **Navigate to Coda**

   Go to your Coda [account settings](https://coda.io/account)

2. **Generate a token**

   Find the API settings section and click on "Generate API token".

   Expand the "Add a restriction" and make sure you select `Type of access: Read only`.

   If you also restrict the token to specific docs, you must enter those doc URLs in **Doc URLs** in Step 2. A token restricted to docs cannot list all docs, so the index fails without the URLs.

   Name it and click Generate API token.

3. **Store the token**

   Copy the token and store it.

   > **Warning:** Treat your API Token like a password. Store it securely and never share it publicly.

### Step 2: Configure Integration in Risotto

1. **Open Coda's page**

   Go to [**Settings** → **Integrations** → **Coda**](https://dashboard.tryrisotto.com/settings/integrations/coda) and click **Add docs**. If you have no index yet, click **Add docs** on the **Docs** row. The **Add docs** dialog opens.

2. **Configure the Index**

   Enter the following required information:

   - **Name**: Name your index (e.g. `IT Docs`). It must be unique.
   - **API token**: Choose a [vault credential](https://www.tryrisotto.com/docs/dashboard/settings/credential-vault) that holds your Coda API token, or click **Add a vault credential** to create one
   - **Organization ID (Optional)**: If your token is scoped to a Coda organization, enter the organization ID (for example, `org-atsL6Kx878`).
   - **Doc URLs (Optional)**: If your token has Coda's "Doc or table" restriction, paste the URL of each doc the token can access, comma-separated. When this field is set, Risotto indexes only these docs and ignores the **Organization ID**.
   - **Excluded doc IDs (Optional)**: If you want the indexing process to skip certain documents you can add a comma separated list here. You can find the document ids in the URL. For example for this URL `https://coda.io/d/My-Playground_dJ2DDM8I9gL` the id is `dJ2DDM8I9gL`. Doc URLs on a branded custom domain (e.g. `docs.example.com/d/...`) work the same way — the id is the same segment. Example of how the value should look like for multiple excluded documents:
     ```text
     dJ2DDM8I9gL,d82Ab8I6g1
     ```
   - **Department** and **Audience**: Choose who gets answers from this index. See [Indexes](https://www.tryrisotto.com/docs/dashboard/knowledge/indexes).

   *Product example: The Add docs dialog on the Coda integration page: a name, an API token from the vault, the optional organization ID, doc URLs and excluded doc IDs, Department and Audience, and Add docs.*

3. **Create and Monitor Index**

   1. Click **Add docs**
   2. Watch the index's card on the **Knowledge** tab: it reads **Indexing** with the number of docs so far. The **Indexing Jobs** panel on **Knowledge > Indexes** shows the same job
   3. Wait for completion before expecting search results

**Create index** on [**Knowledge > Indexes**](https://www.tryrisotto.com/docs/dashboard/knowledge/indexes#create-an-index) still adds a Coda index with the same details, plus an **Index name**. It is the only place to set **Profile filters**.

---

### Monitoring Index Health

- **Check the Indexing Jobs panel** above the indexes table. A running job shows its progress there. A failed job stays there with its error message and a retry button.
- **Check the Count column** of the index to verify expected content was captured

### Reindexing Content

To update your index with the latest changes:

1. Navigate to [**Knowledge** → **Indexes**](https://dashboard.tryrisotto.com/knowledge/indexes)
2. Find your Coda index
3. Click the row's **⋮** menu (**Index actions**), then click **Reindex** to pull the latest changes
4. Monitor progress until completion

> **Note:** Risotto does not reindex Coda content automatically, and you cannot schedule a
> reindex. The index keeps the content from its last run. Click **Reindex**
> after large documentation changes, or on a regular cadence, for example once a
> week. During a reindex, Risotto removes the old content first, so answers do
> not use this index until the run completes.

### Content Verification

After indexing, test that your content is searchable:

- Use [**Knowledge** → **Playground**](https://dashboard.tryrisotto.com/knowledge/playground) to test queries
- Ask questions that should be answered using your indexed content
- Verify that Risotto can find and reference your indexed pages

Source: https://www.tryrisotto.com/docs/integrations/knowledge/coda
