Skip to main content
POST
/
dictionaries
Create a dictionary
curl --request POST \
  --url https://api.vocobase.com/api/v2/dictionaries \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Vocobase Product Catalog",
  "description": "Product names, SKUs, and plan tiers referenced on support calls.",
  "terms": [
    "Vocobase",
    "SKU-4471",
    "Pro Annual Plan",
    "Voice Sandbox",
    "Meera Iyer"
  ]
}
'
{
  "success": true,
  "data": {
    "id": "d1234567-abcd-1234-abcd-123456789012",
    "name": "Vocobase Product Catalog",
    "description": "Product names, SKUs, and plan tiers referenced on support calls.",
    "terms": [
      "Vocobase",
      "SKU-4471",
      "Pro Annual Plan",
      "Voice Sandbox",
      "Meera Iyer"
    ],
    "term_count": 5,
    "char_count": 52,
    "attached_agent_count": 0,
    "created_at": "2026-04-24T10:30:00.000Z",
    "updated_at": "2026-04-24T10:30:00.000Z"
  }
}

Authorizations

Authorization
string
header
required

API key in format: rg_live_xxxx. Pass as a Bearer token in the Authorization header.

Body

application/json
name
string
required

Unique dictionary name (per partner).

Required string length: 1 - 100
description
string | null

Optional description. Blank strings are stored as null.

Maximum string length: 500
terms
string[]

Optional list of terms. Defaults to []. Normalized server-side.

Response

Dictionary created.

success
boolean
data
object