# POST /voice-agent-kbs/:kb_id/documents

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

Add a manually written document to a knowledge base. Pushes the text to Retell and stores a local tracking row. WARNING: Retell add-sources API returns 500 intermittently.

## Parameters

| Name | In | Type | Required | Description |
|------|----|------|----------|-------------|
| `kb_id` | path | uuid | yes | Knowledge base UUID |
| `title` | body | string | yes | Document title |
| `text` | body | string | yes | Document content |

## Request example

```bash
{"title": "Refund Policy", "text": "We offer a 30-day money-back guarantee..."}
```

## Response example

```json
{"document": {"id": "doc-uuid", "title": "Refund Policy", "retell_doc_id": "src_xyz", "source_type": "manual"}}
```

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