Search
Searches Tettra knowledge base for information
Searches your Tettra knowledge base and returns relevant articles and pages to answer user questions.
Setup
Get API Credentials
- Sign into Tettra
- Go to User Settings > My Integrations
- Scroll to My API Keys section
- Note your Team ID (displayed on the page)
- Click Generate API Key
- Copy the API key
Configure in Risotto
In the Risotto dashboard, select Tools in the sidebar. Select Tettra in the Tool groups list. Find Tettra Search and click Set up. Fill in these fields, then click Save:
| Field | Description | Example |
|---|---|---|
| Tettra API Key | Your Tettra API key | abc123def456... |
| Team Id | Your Tettra team ID (number) | 12345 |
Usage
Search Tettra:
"Search Tettra for our vacation policy"
Ask question:
"What's our remote work policy?" (automatically searches Tettra)
How It Works
- Sends search query to Tettra API
- Returns relevant pages that match the query
- Results respect user's Tettra permissions (private categories included if user has access)
- AI uses search results to form a response
Response
Returns formatted results from Tettra pages including:
- Page titles
- Page content/excerpts
- Links to full pages
- Citations to sources
Permissions
- API key inherits your user account's page viewing permissions
- Private categories are searchable if you have access
- Results limited to what your Tettra account can view
Troubleshooting
No API key option:
- Verify you're on Scaling or Professional plan
- Contact Tettra support to enable API access
No results found:
- Check search query spelling
- Verify content exists in Tettra
- Ensure you have permission to view relevant pages
API errors:
- Verify API key and Team ID are correct
- Check API key hasn't been revoked
- Generate new API key if needed
Security Notes
- API keys are user-specific and tied to permissions
- Store API keys securely
- Revoke unused keys in User Settings
- API key has same access as your user account
Something wrong or missing? Report an issue · View as Markdown