Skip to content
/
Approve a vocabulary sugg...
Last updated

Approve a vocabulary suggestion

Write the suggested word into a list and mark the suggestion approved. The word goes to the organization's target list unless list_id names another; the caller needs edit rights on that list. A word already in the list answers DICTIONARY_TERM_DUPLICATE and the suggestion stays pending. Needs the right to manage the team vocabulary.

POSThttps://api.aitronos.com/v1/vocabulary/suggestions/{suggestion_id}/approve

Path Parameters

suggestion_id string required

The suggestion ID.

Request Body

Every field is optional; send {} to write the suggestion as it is.

list_id string optional

The list to write into; null for the organization's target list.

written string optional

How to write the word, 1 to 100 characters; the suggested term when null.

sounds_like array of strings optional

Up to 10 spoken forms; the suggestion's own when null.

language string optional

The language tag; the suggestion's own when null.

kind string optional · Defaults to bias

bias makes the word more likely to be recognized; replace also rewrites each spoken form to the written form.

Returns

suggestion object

The decided suggestion, with the fields of List vocabulary suggestions.

entry object or null

The entry an approval wrote, as returned by Get a vocabulary entry; null on dismiss.

cURL
curl -X POST "https://api.aitronos.com/v1/vocabulary/suggestions/vsug_4e8b2d6f1a3c5097/approve" \
  -H "X-API-Key: $FREDDY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sounds_like": ["cube ernetes"]}'

Response:

200 OK
{
  "suggestion": {
    "id": "vsug_4e8b2d6f1a3c5097",
    "term": "Kubernetes",
    "language": null,
    "source": "learned",
    "people_count": 4,
    "sounds_like": [
      "cube ernetes"
    ],
    "state": "approved",
    "decided_by_user_id": "usr_3c91d0a2b7e4",
    "decided_at": "2026-10-26T09:30:00Z",
    "list_id": "voclist_1b7d5e9f3a2c4680",
    "entry_id": "tdict_5a9c2e7b1d3f4068",
    "refreshed_at": "2026-10-26T09:30:00Z"
  },
  "entry": {
    "id": "tdict_5a9c2e7b1d3f4068",
    "scope": "list",
    "list_id": "voclist_1b7d5e9f3a2c4680",
    "written": "Kubernetes",
    "sounds_like": [
      "cube ernetes"
    ],
    "language": null,
    "kind": "bias",
    "source": "suggested",
    "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": 0,
      "heard_count": 0,
      "corrected_count": 0,
      "last_applied_at": null,
      "last_heard_at": null
    },
    "created_at": "2026-10-26T09:30:00Z",
    "updated_at": "2026-10-26T09:30:00Z"
  }
}
Previous page
Next page