Create a private entry (list_id null) or an entry in a list the caller may add to. A word already in the same place, in the same language, answers 409.
list_id string optional
The list to add the entry to; null creates a private entry.
written string required
How the word is written, 1 to 100 characters.
sounds_like array of string optional
Up to 10 ways the word may be spoken or misheard.
language string optional
A language tag such as de or de-CH; null for all languages.
kind string optional · Defaults to bias
bias or replace.
weight number optional · Defaults to 1.0
How strongly the word is favoured, above 0 and up to 10.
enabled boolean optional · Defaults to true
Whether the entry is used in transcripts.
visibility string optional
For an entry in a list: list (the default) or restricted. Not allowed on a private entry.
The new vocabulary entry:
id string
The entry ID: pdict_… for a private entry, tdict_… for one in a list.
scope string
personal for a private entry, list for an entry in a list.
list_id string or null
The list the entry belongs to, if any.
written string
How the word is written.
sounds_like array of string
How the word may be spoken or misheard.
language string or null
The language tag; null for all languages.
kind string
bias makes the word more likely to be recognised; replace also rewrites the spoken forms to the written form.
source string
How the entry was created.
weight number
How strongly the word is favoured, above 0 and up to 10.
enabled boolean
Whether the entry is used in transcripts.
visibility string
private for a private entry; list when everyone who reads the list sees it; restricted when only the people it is shared with see it.
shared boolean
Whether the entry is shared on its own.
owner_user_id string
The person who created the entry.
reached_through string
How the entry reached the caller.
can_edit boolean
Whether the caller may change the entry.
can_share boolean
Whether the caller may share the entry.
stats object
Usage counters: applied_count, heard_count, corrected_count, last_applied_at, last_heard_at.
created_at string
When the entry was created.
updated_at string
When the entry last changed.
- Bash
- Python
- JavaScript
curl -X POST "https://api.aitronos.com/v1/vocabulary/entries" \
-H "X-API-Key: $FREDDY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"list_id": "voclist_8f2a61c4e0b94d7a", "written": "Kubernetes", "sounds_like": ["cube ernetes", "kuber netties"]}'Response:
{
"id": "tdict_5a9c2e7b1d3f4068",
"scope": "list",
"list_id": "voclist_8f2a61c4e0b94d7a",
"written": "Kubernetes",
"sounds_like": [
"cube ernetes",
"kuber netties"
],
"language": null,
"kind": "bias",
"source": "manual",
"weight": 1.0,
"enabled": true,
"visibility": "list",
"shared": false,
"owner_user_id": "usr_3c91d0a2b7e4",
"reached_through": "owner",
"can_edit": true,
"can_share": true,
"stats": {
"applied_count": 14,
"heard_count": 9,
"corrected_count": 0,
"last_applied_at": "2026-10-24T09:30:00Z",
"last_heard_at": "2026-10-24T09:30:00Z"
},
"created_at": "2026-10-24T09:30:00Z",
"updated_at": "2026-10-24T09:30:00Z"
}- Vocabulary API — Overview of lists, entries and settings.
- Create an access grant — Share a vocabulary list with people, teams or the whole organization.