# 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

1. Sign into Tettra
2. Go to **User Settings** > **My Integrations**
3. Scroll to **My API Keys** section
4. Note your **Team ID** (displayed on the page)
5. Click **Generate API Key**
6. Copy the API key

> **Note:** API keys are only available on Scaling and Professional (Enterprise) plans.

### 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

1. Sends search query to Tettra API
2. Returns relevant pages that match the query
3. Results respect user's Tettra permissions (private categories included if user has access)
4. 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

Source: https://www.tryrisotto.com/docs/integrations/tools/tettra/search
