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:
- Coda API Token - You only need read access for the token
Setup Process
Step 1: Get Coda API Token
Go to your Coda account settings
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.
Store the token
Copy the token and store it.
Step 2: Configure Integration in Risotto
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.
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_dJ2DDM8I9gLthe id isdJ2DDM8I9gL. 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.
- Name: Name your index (e.g.
Create and Monitor Index
- Click Add docs
- 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
- 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:
- Navigate to Knowledge → Indexes
- Find your Coda index
- Click the row's ⋮ menu (Index actions), then click Reindex to pull the latest changes
- 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