> ## Documentation Index
> Fetch the complete documentation index at: https://krastieai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Brand voice library

> Manage brand voices for visibility-optimized content generation.

Base path: `/v1/ai/brand-voice`

Consistent brand voice reinforces how AI models understand your business. Use these endpoints to manage saved voices applied during content generation.

| Method | Endpoint | Description |
| - | - | - |
| `GET` | `/` | List all brand voices |
| `GET` | `/:id` | Get one brand voice |
| `PUT` | `/:id` | Update brand voice |
| `DELETE` | `/:id` | Delete brand voice |

To **create** a brand voice from a website, text sample, or file, use the generate routes in [Content generation endpoints](/api-reference/ai-generation#brand-voice-generate-routes):

* `POST /v1/ai/generate/brand-voice/website`
* `POST /v1/ai/generate/brand-voice/text`
* `POST /v1/ai/generate/brand-voice/file`

Creating from your website URL is recommended — Krastie analyzes your existing content to capture tone and entity signals.

## List brand voices

```bash theme={null}
curl https://api.krastie.ai/v1/ai/brand-voice \
  -H "api-key: krastie_YOUR_KEY"
```

## Get a brand voice

```bash theme={null}
curl https://api.krastie.ai/v1/ai/brand-voice/BRAND_VOICE_ID \
  -H "api-key: krastie_YOUR_KEY"
```

## Use in content generation

Pass `brandVoiceId` when creating content to close visibility gaps:

```bash theme={null}
curl -X POST https://api.krastie.ai/v1/ai/generate/text \
  -H "Content-Type: application/json" \
  -H "api-key: krastie_YOUR_KEY" \
  -d '{
    "text": "Write a comparison page for prompts where we lose to competitors.",
    "model": "gpt-4o",
    "brandVoiceId": "BRAND_VOICE_ID"
  }'
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.