Docs

Integrations / Knowledge

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. Go to your Coda account settings

  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.

Step 2: Configure Integration in Risotto

  1. Open Coda's page

    Go to 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 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:
      dJ2DDM8I9gL,d82Ab8I6g1
    • Department and Audience: Choose who gets answers from this index. See Indexes.
  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 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
  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

Content Verification

After indexing, test that your content is searchable:

  • Use 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

Something wrong or missing? Report an issue · View as Markdown