Introducing our new Monitoring feature Learn more

Documentation

Brand voice

List, fetch, update, and delete brand voices with the Krastie API.

Brand voice

Base path: /v1/ai/brand-voice

Create new brand voices with the Generate endpoints (/brand-voice/website, /text, /file). Use these routes to manage existing voices.

List brand voices

GET /v1/ai/brand-voice/

curl https://api.krastie.ai/v1/ai/brand-voice/ \
  -H "api-key: YOUR_KEY"
{
  "message": "Brand voices fetched successfully.",
  "data": [
    {
      "id": "…",
      "name": "Brand Voice - 7/9/2026",
      "type": "website",
      "url": "https://example.com",
      "contentLength": 12000,
      "createdAt": "…",
      "updatedAt": "…"
    }
  ]
}

Get a brand voice

GET /v1/ai/brand-voice/:id

Returns the full voice including content.

{
  "message": "Brand voice fetched successfully.",
  "data": {
    "id": "…",
    "name": "…",
    "type": "website",
    "url": "https://example.com",
    "content": "…",
    "fetchInterval": "once",
    "createdAt": "…",
    "updatedAt": "…"
  }
}

Update a brand voice

PUT /v1/ai/brand-voice/:id

FieldTypeDescription
namestringDisplay name
contentstringFull brand voice content
urlstringSource URL (website voices)
fetchIntervalstringRefresh interval
curl -X PUT https://api.krastie.ai/v1/ai/brand-voice/VOICE_ID \
  -H "api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Acme voice","content":"Tone: clear, confident…"}'

Delete a brand voice

DELETE /v1/ai/brand-voice/:id

Soft-deletes the voice (isActive: false).

{ "message": "Brand voice deleted successfully." }