# POST /voice-agent-kbs

**Resource:** [Agent Knowledge Bases](./voice-agent-kbs.md)  
**Scopes:** `voice-kbs:write`  
**Write operation:** yes

Create a new knowledge base. source="help_center" seeds it with all help center articles automatically. source="custom" (default) starts empty or accepts initial_texts. WARNING: Retell KB create API returns 500 intermittently -- this is a Retell-side outage.

## Parameters

| Name | In | Type | Required | Description |
|------|----|------|----------|-------------|
| `name` | body | string | yes | Knowledge base name |
| `description` | body | string | no | Optional description |
| `source` | body | string | no | "help_center" to seed from articles, or "custom" (default) for manual content |
| `initial_texts` | body | array | no | Initial documents for custom KBs. Each item: {title: string, text: string}. Ignored when source="help_center". |

## Request example

```bash
{"name": "Product FAQ", "source": "custom", "initial_texts": [{"title": "Pricing", "text": "Our pricing starts at $49/month..."}]}
```

## Response example

```json
{"kb": {"id": "uuid", "name": "Product FAQ", "retell_kb_id": "kb_abc123", "source": "custom"}}
```

---
Base URL: `https://api.trustpager.com/functions/v1/api/v1` — Auth: `Authorization: Bearer YOUR_API_KEY`