{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-docs/api-reference/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["api-container","api-content","endpoint","api-examples","tabs","tab","code-group"]},"redocly_category":"API Reference","searchWeight":120,"type":"markdown"},"seo":{"title":"Approve a vocabulary suggestion","description":"Complete API reference and documentation for Freddy AI-powered backend system by Aitronos","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"approve-a-vocabulary-suggestion","__idx":0},"children":["Approve a vocabulary suggestion"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Write the suggested word into a list and mark the suggestion approved. The word goes to the organization's target list unless ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list_id"]}," names another; the caller needs edit rights on that list. A word already in the list answers ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DICTIONARY_TERM_DUPLICATE"]}," and the suggestion stays pending. Needs the right to manage the team vocabulary."]},{"$$mdtype":"Tag","name":"ApiContainer","attributes":{},"children":[{"$$mdtype":"Tag","name":"ApiContent","attributes":{},"children":[{"$$mdtype":"Tag","name":"Endpoint","attributes":{"method":"POST","path":"https://api.aitronos.com/v1/vocabulary/suggestions/{suggestion_id}/approve"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"path-parameters","__idx":1},"children":["Path Parameters"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["suggestion_id"]}]}," string ",{"$$mdtype":"Tag","name":"em","attributes":{"style":{"color":"#ef4444 !important","fontWeight":"600 !important","fontStyle":"normal !important"}},"children":["required"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The suggestion ID."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"request-body","__idx":2},"children":["Request Body"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Every field is optional; send ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{}"]}," to write the suggestion as it is."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list_id"]}]}," string ",{"$$mdtype":"Tag","name":"em","attributes":{"style":{"color":"#9ca3af !important","fontWeight":"500 !important","fontStyle":"normal !important"}},"children":["optional"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The list to write into; null for the organization's target list."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["written"]}]}," string ",{"$$mdtype":"Tag","name":"em","attributes":{"style":{"color":"#9ca3af !important","fontWeight":"500 !important","fontStyle":"normal !important"}},"children":["optional"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["How to write the word, 1 to 100 characters; the suggested term when null."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sounds_like"]}]}," array of strings ",{"$$mdtype":"Tag","name":"em","attributes":{"style":{"color":"#9ca3af !important","fontWeight":"500 !important","fontStyle":"normal !important"}},"children":["optional"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Up to 10 spoken forms; the suggestion's own when null."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["language"]}]}," string ",{"$$mdtype":"Tag","name":"em","attributes":{"style":{"color":"#9ca3af !important","fontWeight":"500 !important","fontStyle":"normal !important"}},"children":["optional"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The language tag; the suggestion's own when null."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["kind"]}]}," string ",{"$$mdtype":"Tag","name":"em","attributes":{"style":{"color":"#9ca3af !important","fontWeight":"500 !important","fontStyle":"normal !important"}},"children":["optional"]}," · Defaults to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bias"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bias"]}," makes the word more likely to be recognized; ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["replace"]}," also rewrites each spoken form to the written form."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"returns","__idx":3},"children":["Returns"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["suggestion"]}]}," object"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The decided suggestion, with the fields of ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api-reference/vocabulary/list-vocabulary-suggestions"},"children":["List vocabulary suggestions"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["entry"]}]}," object or null"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The entry an approval wrote, as returned by ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api-reference/vocabulary/get-a-vocabulary-entry"},"children":["Get a vocabulary entry"]},"; null on dismiss."]}]},{"$$mdtype":"Tag","name":"ApiExamples","attributes":{},"children":[{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"Example","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeGroup","attributes":{"mode":"dropdown"},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","data-title":"cURL","header":{"title":"cURL","controls":{"copy":{}}},"source":"curl -X POST \"https://api.aitronos.com/v1/vocabulary/suggestions/vsug_4e8b2d6f1a3c5097/approve\" \\\n  -H \"X-API-Key: $FREDDY_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"sounds_like\": [\"cube ernetes\"]}'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"python","data-title":"Python","header":{"title":"Python","controls":{"copy":{}}},"source":"import os\nimport requests\n\napi_key = os.environ[\"FREDDY_API_KEY\"]\n\nresponse = requests.post(\n    \"https://api.aitronos.com/v1/vocabulary/suggestions/vsug_4e8b2d6f1a3c5097/approve\",\n    headers={\"X-API-Key\": api_key},\n    json={\"sounds_like\": [\"cube ernetes\"]},\n)\n\nprint(response.json())\n","lang":"python"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","data-title":"JavaScript","header":{"title":"JavaScript","controls":{"copy":{}}},"source":"const apiKey = process.env.FREDDY_API_KEY;\n\nconst response = await fetch('https://api.aitronos.com/v1/vocabulary/suggestions/vsug_4e8b2d6f1a3c5097/approve', {\n  method: 'POST',\n  headers: {\n    'X-API-Key': apiKey,\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({\"sounds_like\": [\"cube ernetes\"]})\n});\n\nconst data = await response.json();\nconsole.log(data);\n","lang":"javascript"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","data-title":"200 OK","header":{"title":"200 OK","controls":{"copy":{}}},"source":"{\n  \"suggestion\": {\n    \"id\": \"vsug_4e8b2d6f1a3c5097\",\n    \"term\": \"Kubernetes\",\n    \"language\": null,\n    \"source\": \"learned\",\n    \"people_count\": 4,\n    \"sounds_like\": [\n      \"cube ernetes\"\n    ],\n    \"state\": \"approved\",\n    \"decided_by_user_id\": \"usr_3c91d0a2b7e4\",\n    \"decided_at\": \"2026-10-26T09:30:00Z\",\n    \"list_id\": \"voclist_1b7d5e9f3a2c4680\",\n    \"entry_id\": \"tdict_5a9c2e7b1d3f4068\",\n    \"refreshed_at\": \"2026-10-26T09:30:00Z\"\n  },\n  \"entry\": {\n    \"id\": \"tdict_5a9c2e7b1d3f4068\",\n    \"scope\": \"list\",\n    \"list_id\": \"voclist_1b7d5e9f3a2c4680\",\n    \"written\": \"Kubernetes\",\n    \"sounds_like\": [\n      \"cube ernetes\"\n    ],\n    \"language\": null,\n    \"kind\": \"bias\",\n    \"source\": \"suggested\",\n    \"weight\": 1.0,\n    \"enabled\": true,\n    \"visibility\": \"list\",\n    \"shared\": false,\n    \"owner_user_id\": \"usr_3c91d0a2b7e4\",\n    \"reached_through\": \"owner\",\n    \"can_edit\": true,\n    \"can_share\": true,\n    \"stats\": {\n      \"applied_count\": 0,\n      \"heard_count\": 0,\n      \"corrected_count\": 0,\n      \"last_applied_at\": null,\n      \"last_heard_at\": null\n    },\n    \"created_at\": \"2026-10-26T09:30:00Z\",\n    \"updated_at\": \"2026-10-26T09:30:00Z\"\n  }\n}\n","lang":"json"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Errors","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","data-title":"401 Unauthorized","header":{"title":"401 Unauthorized","controls":{"copy":{}}},"source":"{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"AUTHENTICATION_REQUIRED\",\n    \"message\": \"Authentication required. Please provide a valid API key.\",\n    \"system_message\": \"Missing or invalid authorization header\",\n    \"type\": \"authentication_error\",\n    \"status\": 401,\n    \"details\": {},\n    \"trace_id\": \"req_7d1e4b9a2c\",\n    \"timestamp\": \"2026-10-26T09:30:00Z\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","data-title":"403 Forbidden","header":{"title":"403 Forbidden","controls":{"copy":{}}},"source":"{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"INSUFFICIENT_PERMISSIONS\",\n    \"message\": \"You do not have permission to perform this action.\",\n    \"system_message\": \"Caller lacks the rights this operation needs.\",\n    \"type\": \"authorization_error\",\n    \"status\": 403,\n    \"details\": {},\n    \"trace_id\": \"req_7d1e4b9a2c\",\n    \"timestamp\": \"2026-10-26T09:30:00Z\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","data-title":"404 Not Found","header":{"title":"404 Not Found","controls":{"copy":{}}},"source":"{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"SUGGESTION_NOT_FOUND\",\n    \"message\": \"This vocabulary suggestion does not exist.\",\n    \"system_message\": \"Vocabulary suggestion not found.\",\n    \"type\": \"client_error\",\n    \"status\": 404,\n    \"details\": {},\n    \"trace_id\": \"req_7d1e4b9a2c\",\n    \"timestamp\": \"2026-10-26T09:30:00Z\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","data-title":"409 Conflict","header":{"title":"409 Conflict","controls":{"copy":{}}},"source":"{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"VOCABULARY_SUGGESTION_DECIDED\",\n    \"message\": \"This vocabulary suggestion was already decided.\",\n    \"system_message\": \"Vocabulary suggestion already decided.\",\n    \"type\": \"client_error\",\n    \"status\": 409,\n    \"details\": {},\n    \"trace_id\": \"req_7d1e4b9a2c\",\n    \"timestamp\": \"2026-10-26T09:30:00Z\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","data-title":"409 Conflict","header":{"title":"409 Conflict","controls":{"copy":{}}},"source":"{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"DICTIONARY_TERM_DUPLICATE\",\n    \"message\": \"This word is already in the list.\",\n    \"system_message\": \"Duplicate vocabulary entry.\",\n    \"type\": \"client_error\",\n    \"status\": 409,\n    \"details\": {},\n    \"trace_id\": \"req_7d1e4b9a2c\",\n    \"timestamp\": \"2026-10-26T09:30:00Z\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","data-title":"422 Unprocessable Entity","header":{"title":"422 Unprocessable Entity","controls":{"copy":{}}},"source":"{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"VOCABULARY_ENTRY_INVALID\",\n    \"message\": \"The vocabulary entry is not valid.\",\n    \"system_message\": \"Invalid vocabulary entry.\",\n    \"type\": \"validation_error\",\n    \"status\": 422,\n    \"details\": {\n      \"reason\": \"replace_needs_sounds_like\"\n    },\n    \"trace_id\": \"req_7d1e4b9a2c\",\n    \"timestamp\": \"2026-10-26T09:30:00Z\"\n  }\n}\n","lang":"json"},"children":[]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-resources","__idx":4},"children":["Related Resources"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api-reference/vocabulary/dismiss-a-vocabulary-suggestion"},"children":["Dismiss a vocabulary suggestion"]}," — Never suggest the word again."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api-reference/vocabulary/approve-or-dismiss-vocabulary-suggestions-in-bulk"},"children":["Approve or dismiss vocabulary suggestions in bulk"]}," — Decide up to 100 at once."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api-reference/vocabulary/_index"},"children":["Vocabulary API"]}," — Overview of lists, entries and settings."]}]}]},"headings":[{"value":"Approve a vocabulary suggestion","id":"approve-a-vocabulary-suggestion","depth":1},{"value":"Path Parameters","id":"path-parameters","depth":4},{"value":"Request Body","id":"request-body","depth":4},{"value":"Returns","id":"returns","depth":2},{"value":"Related Resources","id":"related-resources","depth":2}],"frontmatter":{"title":"Approve a vocabulary suggestion","keywords":["approve a vocabulary suggestion","post","approve","vocabulary","suggestion"],"seo":{"title":"Approve a vocabulary suggestion"}},"lastModified":"2026-10-26T18:31:40.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/api-reference/vocabulary/approve-a-vocabulary-suggestion","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}