Add up to 200 words in one call. Words are deduplicated case-insensitively, and any that already exist are returned as-is rather than duplicated. Requires dictionary:write on a personal key (owk_live_). Returns 403 forbidden for managed users whose organization has turned off cloud backup.
Words to add. Each is 1-100 characters and may not contain <, > or line breaks. Deduplicated case-insensitively; words already in the dictionary are returned rather than duplicated.
Required array length: 1 - 200 elements
Required string length: 1 - 100
Response
The entries for every word sent, including ones that already existed.
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"OpenWhispr","colors":{"primary":"#2563EB","light":"#60A5FA","dark":"#3B82F6"},"logo":{"light":"https://mintcdn.com/openwhispr/AruQy2K60UKy6SJT/images/logo.svg?fit=max\u0026auto=format\u0026n=AruQy2K60UKy6SJT\u0026q=85\u0026s=73ef2a1292e4c40bd5bccbabe1b0767a","dark":"https://mintcdn.com/openwhispr/AruQy2K60UKy6SJT/images/logo.svg?fit=max\u0026auto=format\u0026n=AruQy2K60UKy6SJT\u0026q=85\u0026s=73ef2a1292e4c40bd5bccbabe1b0767a","href":"https://openwhispr.com"},"favicon":"https://mintcdn.com/openwhispr/AruQy2K60UKy6SJT/images/logo.svg?fit=max\u0026auto=format\u0026n=AruQy2K60UKy6SJT\u0026q=85\u0026s=73ef2a1292e4c40bd5bccbabe1b0767a","appearance":{"default":"system"},"background":{"color":{"light":"#F7F9FB","dark":"#080C16"}},"navbar":{"links":[{"href":"https://openwhispr.com","label":"Website"},{"href":"https://github.com/OpenWhispr/openwhispr","label":"GitHub"}],"primary":{"type":"button","label":"Contact support","href":"mailto:support@openwhispr.com"}},"footer":{"socials":{"github":"https://github.com/OpenWhispr/openwhispr","x":"https://x.com/openwhispr"}},"fonts":{"family":"Space Grotesk"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"openwhispr","hasAudioNarration":false,"actualSubdomain":"openwhispr","customDomains":["docs.openwhispr.com"],"gitSource":{"type":"github","owner":"openwhispr","repo":"openwhispr-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ad89592078d5ac10ac9883d","collectionId":"80e0c993-f1ba-4ec6-b2bd-e6b3ada2d45e","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ad89592078d5ac10ac9883d"},"entitlements":{},"buildId":"6ad89592078d5ac10ac9883d","clientVersion":"0.0.4067","searchFilterCounts":[{"language":"default","tag":"Help Center","count":100},{"language":"default","tag":"API Reference","count":29},{"language":"default","tag":"Troubleshooting","count":19},{"language":"default","tag":"Account \u0026 billing","count":17},{"language":"default","tag":"Developers","count":14},{"language":"default","tag":"Dictation","count":10},{"language":"default","tag":"Platforms \u0026 compatibility","count":10},{"language":"default","tag":"Meetings","count":9},{"language":"default","tag":"Dictation problems","count":8},{"language":"default","tag":"Notes, search \u0026 sync","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":"kbd{display:inline-block;white-space:nowrap;min-width:1.75em;text-align:center;line-height:1.5}"}],"page":{"pagePath":"api-reference/dictionary/add-dictionary-words","slug":"/api-reference/dictionary/add-dictionary-words","pageMetadata":{"title":"Add dictionary words","description":"Add up to 200 words in one call. Words are deduplicated case-insensitively, and any that already exist are returned as-is rather than duplicated. Requires dictionary:write on a personal key (owk_live_). Returns 403 forbidden for managed users whose organization has turned off cloud backup.","deprecated":null,"version":null,"openapi":"/openapi.json post /dictionary/create","href":"/api-reference/dictionary/add-dictionary-words","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Add up to 200 words in one call. Words are deduplicated case-insensitively, and any that already exist are returned as-is rather than duplicated. Requires dictionary:write on a personal key (owk_live_). Returns 403 forbidden for managed users whose organization has turned off cloud backup.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Add dictionary words","description":"Add up to 200 words in one call. Words are deduplicated case-insensitively, and any that already exist are returned as-is rather than duplicated. Requires dictionary:write on a personal key (owk_live_). Returns 403 forbidden for managed users whose organization has turned off cloud backup.","deprecated":null,"version":null,"openapi":"/openapi.json post /dictionary/create","href":"/api-reference/dictionary/add-dictionary-words","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Add dictionary words","description":"Add up to 200 words in one call. Words are deduplicated case-insensitively, and any that already exist are returned as-is rather than duplicated. Requires dictionary:write on a personal key (owk_live_). Returns 403 forbidden for managed users whose organization has turned off cloud backup.","operationId":"createDictionaryWords","tags":["Dictionary"],"requestBody":"e1dd970b-e8da-4266-a1c5-42c772bd8c0a","responses":{"201":"c8e0b5be-5734-485f-8847-9266b49cb744","400":"afda6880-4c4a-4b49-a3de-9c8a7e532956","403":"6c1319ed-4ad7-458e-9dd5-2f926e8667cd"},"method":"post","type":"path","servers":["21f576fd-328d-419a-a4fb-df4d39242746"],"security":["28779325-6c4b-44b2-8e77-c477df2c3f4e"],"path":"/dictionary/create","baseUrlOptions":["https://api.openwhispr.com/api/v1"],"title":"Add dictionary words","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["words"],"properties":{"words":{"type":"array","minItems":1,"maxItems":200,"items":{"type":"string","minLength":1,"maxLength":100,"uniqueKey":"words.items.[INDEX]","typeLabel":"string"},"description":"Words to add. Each is 1-100 characters and may not contain \u003c, > or line breaks. Deduplicated case-insensitively; words already in the dictionary are returned rather than duplicated.","isRequired":true,"uniqueKey":"words","typeLabel":"string[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"words":["\u003cstring>"]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"c8e0b5be-5734-485f-8847-9266b49cb744":{"description":"The entries for every word sent, including ones that already existed.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","uniqueKey":"data.items.[INDEX].id","typeLabel":"string"},"word":{"type":"string","uniqueKey":"data.items.[INDEX].word","typeLabel":"string"},"source":{"type":"string","enum":["manual","learned"],"description":"`manual` for words you added; `learned` for words added automatically by auto-learn from corrections.","uniqueKey":"data.items.[INDEX].source","typeLabel":"enum\u003cstring>"},"created_at":{"type":"string","format":"date-time","uniqueKey":"data.items.[INDEX].created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","format":"date-time","uniqueKey":"data.items.[INDEX].updated_at","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"data.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":[{"id":"\u003cstring>","word":"\u003cstring>","source":"manual","created_at":"2023-11-07T05:31:56Z","updated_at":"2023-11-07T05:31:56Z"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"afda6880-4c4a-4b49-a3de-9c8a7e532956":{"description":"Validation error — empty list, more than 200 words, a word outside 1-100 characters, or one containing \u003c, > or a line break.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"required":["code","message"],"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"6c1319ed-4ad7-458e-9dd5-2f926e8667cd":{"description":"Missing dictionary:write, a workspace key, or cloud backup turned off by your organization.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"required":["code","message"],"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"28779325-6c4b-44b2-8e77-c477df2c3f4e":{"bearerAuth":{"type":"http","scheme":"bearer","description":"API key starting with owk_live_ (personal) or ow_wks_live_ (workspace — see space_id on the Notes/Folders endpoints below)","scopes":[]}}},"servers":{"21f576fd-328d-419a-a4fb-df4d39242746":{"url":"https://api.openwhispr.com/api/v1","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"API key starting with owk_live_ (personal) or ow_wks_live_ (workspace — see space_id on the Notes/Folders endpoints below)","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API key starting with owk_live_ (personal) or ow_wks_live_ (workspace — see space_id on the Notes/Folders endpoints below)","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"openwhispr","siteName":"OpenWhispr","title":"Add dictionary words - OpenWhispr","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-13T21:50:19.446Z","originalFileLocation":"api-reference/dictionary/add-dictionary-words.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Add up to 200 words in one call. Words are deduplicated case-insensitively, and any that already exist are returned as-is rather than duplicated. Requires dictionary:write on a personal key (owk_live_). Returns 403 forbidden for managed users whose organization has turned off cloud backup.\">\u003cmeta data-mint-head name=\"application-name\" content=\"OpenWhispr\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/openwhispr/-JbKQO6qzVwxtMKU/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/openwhispr/-JbKQO6qzVwxtMKU/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/openwhispr/-JbKQO6qzVwxtMKU/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/openwhispr/-JbKQO6qzVwxtMKU/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/openwhispr/-JbKQO6qzVwxtMKU/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/openwhispr/-JbKQO6qzVwxtMKU/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/openwhispr/-JbKQO6qzVwxtMKU/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/openwhispr/-JbKQO6qzVwxtMKU/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/openwhispr/-JbKQO6qzVwxtMKU/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Add dictionary words - OpenWhispr\">\u003cmeta data-mint-head property=\"og:description\" content=\"Add up to 200 words in one call. Words are deduplicated case-insensitively, and any that already exist are returned as-is rather than duplicated. Requires dictionary:write on a personal key (owk_live_). Returns 403 forbidden for managed users whose organization has turned off cloud backup.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"OpenWhispr\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.openwhispr.com/api-reference/dictionary/add-dictionary-words\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://openwhispr.mintlify.app/_mintlify/api/og/v2?division=Dictionary\u0026amp;title=Add+dictionary+words\u0026amp;description=Add+up+to+200+words+in+one+call.+Words+are+deduplicated+case-insensitively%2C+and+any+that+already+exist+are+returned+as-is+rather+than+duplicated.+Requires+dicti\u0026amp;theme=6a9eec330f0aa7431277284c\u0026amp;signature=5cf025bb1c056e4131e234bf72b4e25a1b3a2a4f335753a994758b42a1d0bbed\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Add dictionary words - OpenWhispr\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Add up to 200 words in one call. Words are deduplicated case-insensitively, and any that already exist are returned as-is rather than duplicated. Requires dictionary:write on a personal key (owk_live_). Returns 403 forbidden for managed users whose organization has turned off cloud backup.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://openwhispr.mintlify.app/_mintlify/api/og/v2?division=Dictionary\u0026amp;title=Add+dictionary+words\u0026amp;description=Add+up+to+200+words+in+one+call.+Words+are+deduplicated+case-insensitively%2C+and+any+that+already+exist+are+returned+as-is+rather+than+duplicated.+Requires+dicti\u0026amp;theme=6a9eec330f0aa7431277284c\u0026amp;signature=5cf025bb1c056e4131e234bf72b4e25a1b3a2a4f335753a994758b42a1d0bbed\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/openwhispr/-JbKQO6qzVwxtMKU/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"OpenWhispr\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2563EB\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.openwhispr.com/api-reference/dictionary/add-dictionary-words\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/dictionary/add-dictionary-words.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.openwhispr.com/#organization\",\"name\":\"OpenWhispr\",\"url\":\"https://docs.openwhispr.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/openwhispr/AruQy2K60UKy6SJT/images/logo.svg?fit=max\u0026auto=format\u0026n=AruQy2K60UKy6SJT\u0026q=85\u0026s=73ef2a1292e4c40bd5bccbabe1b0767a\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.openwhispr.com#website\",\"name\":\"OpenWhispr\",\"url\":\"https://docs.openwhispr.com\",\"publisher\":{\"@id\":\"https://docs.openwhispr.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.openwhispr.com/api-reference/dictionary/add-dictionary-words#webpage\",\"url\":\"https://docs.openwhispr.com/api-reference/dictionary/add-dictionary-words\",\"name\":\"Add dictionary words\",\"description\":\"Add up to 200 words in one call. Words are deduplicated case-insensitively, and any that already exist are returned as-is rather than duplicated. Requires dictionary:write on a personal key (owk_live_). Returns 403 forbidden for managed users whose organization has turned off cloud backup.\",\"dateModified\":\"2026-09-13T21:50:19.446Z\",\"isPartOf\":{\"@id\":\"https://docs.openwhispr.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.openwhispr.com/api-reference/dictionary/add-dictionary-words#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.openwhispr.com/api-reference/dictionary/add-dictionary-words#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Dictionary\",\"item\":\"https://docs.openwhispr.com/api-reference/dictionary/list-dictionary-words\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Add dictionary words\",\"item\":\"https://docs.openwhispr.com/api-reference/dictionary/add-dictionary-words\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.openwhispr.com/api-reference/dictionary/add-dictionary-words#apireference\",\"headline\":\"Add dictionary words\",\"name\":\"Add dictionary words\",\"description\":\"Add up to 200 words in one call. Words are deduplicated case-insensitively, and any that already exist are returned as-is rather than duplicated. Requires dictionary:write on a personal key (owk_live_). Returns 403 forbidden for managed users whose organization has turned off cloud backup.\",\"url\":\"https://docs.openwhispr.com/api-reference/dictionary/add-dictionary-words\",\"mainEntityOfPage\":{\"@id\":\"https://docs.openwhispr.com/api-reference/dictionary/add-dictionary-words#webpage\"},\"dateModified\":\"2026-09-13T21:50:19.446Z\",\"publisher\":{\"@id\":\"https://docs.openwhispr.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.openwhispr.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"OpenWhispr\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"OpenWhispr","nav":{"global":null,"tabs":[{"tab":"Help Center","pages":[{"title":"Help Center","href":""}]},{"tab":"Developers","pages":[{"title":"Developers","href":"/api/overview"}]},{"tab":"API Reference","groups":[{"group":"Notes","pages":[{"title":"List notes","deprecated":null,"version":null,"openapi":"/openapi.json get /notes/list","href":"/api-reference/notes/list-notes"},{"title":"Get note","deprecated":null,"version":null,"openapi":"/openapi.json get /notes/{id}","href":"/api-reference/notes/get-note"},{"title":"Create note","deprecated":null,"version":null,"openapi":"/openapi.json post /notes/create","href":"/api-reference/notes/create-note"},{"title":"Update note","deprecated":null,"version":null,"openapi":"/openapi.json patch /notes/{id}","href":"/api-reference/notes/update-note"},{"title":"Delete note","deprecated":null,"version":null,"openapi":"/openapi.json delete /notes/{id}","href":"/api-reference/notes/delete-note"},{"title":"Search notes","deprecated":null,"version":null,"openapi":"/openapi.json post /notes/search","href":"/api-reference/notes/search-notes"}]},{"group":"Folders","pages":[{"title":"List folders","deprecated":null,"version":null,"openapi":"/openapi.json get /folders/list","href":"/api-reference/folders/list-folders"},{"title":"Create folder","deprecated":null,"version":null,"openapi":"/openapi.json post /folders/create","href":"/api-reference/folders/create-folder"}]},{"group":"Transcriptions","pages":[{"title":"Transcribe audio (beta)","deprecated":null,"version":null,"openapi":"/openapi.json post /transcribe","href":"/api-reference/transcriptions/transcribe-audio-beta"},{"title":"List transcriptions","deprecated":null,"version":null,"openapi":"/openapi.json get /transcriptions/list","href":"/api-reference/transcriptions/list-transcriptions"},{"title":"Get transcription","deprecated":null,"version":null,"openapi":"/openapi.json get /transcriptions/{id}","href":"/api-reference/transcriptions/get-transcription"},{"title":"Delete transcription","deprecated":null,"version":null,"openapi":"/openapi.json delete /transcriptions/{id}","href":"/api-reference/transcriptions/delete-transcription"},{"title":"Get note transcript","deprecated":null,"version":null,"openapi":"/openapi.json get /notes/{id}/transcript","href":"/api-reference/transcriptions/get-note-transcript"}]},{"group":"Dictionary","pages":[{"title":"List dictionary words","description":"List your custom dictionary entries with cursor pagination. Requires dictionary:read on a personal key (owk_live_). Workspace keys (ow_wks_live_) get 403.","deprecated":null,"version":null,"openapi":"/openapi.json get /dictionary/list","href":"/api-reference/dictionary/list-dictionary-words"},{"title":"Add dictionary words","deprecated":null,"version":null,"openapi":"/openapi.json post /dictionary/create","href":"/api-reference/dictionary/add-dictionary-words"},{"title":"Update dictionary word","description":"Change an entry's spelling. Requires dictionary:write on a personal key (owk_live_). Returns 403 forbidden for managed users whose organization has turned off cloud backup.","deprecated":null,"version":null,"openapi":"/openapi.json patch /dictionary/{id}","href":"/api-reference/dictionary/update-dictionary-word"},{"title":"Delete dictionary word","deprecated":null,"version":null,"openapi":"/openapi.json delete /dictionary/{id}","href":"/api-reference/dictionary/delete-dictionary-word"}]},{"group":"Snippets","pages":[{"title":"List snippets","deprecated":null,"version":null,"openapi":"/openapi.json get /snippets/list","href":"/api-reference/snippets/list-snippets"},{"title":"Create snippet","deprecated":null,"version":null,"openapi":"/openapi.json post /snippets/create","href":"/api-reference/snippets/create-snippet"},{"title":"Update snippet","deprecated":null,"version":null,"openapi":"/openapi.json patch /snippets/{id}","href":"/api-reference/snippets/update-snippet"},{"title":"Delete snippet","deprecated":null,"version":null,"openapi":"/openapi.json delete /snippets/{id}","href":"/api-reference/snippets/delete-snippet"}]},{"group":"Usage","pages":[{"title":"Get usage","deprecated":null,"version":null,"openapi":"/openapi.json get /usage","href":"/api-reference/usage/get-usage"},{"title":"Get the current credential","deprecated":null,"version":null,"openapi":"/openapi.json get /me","href":"/api-reference/usage/get-the-current-credential"}]},{"group":"Auth","pages":[{"title":"Request verification code","deprecated":null,"version":null,"openapi":"/openapi.json post /auth/email-code","href":"/api-reference/auth/request-verification-code"},{"title":"Verify code","deprecated":null,"version":null,"openapi":"/openapi.json post /auth/email-code/verify","href":"/api-reference/auth/verify-code"}]},{"group":"Keys","pages":[{"title":"Create API key","deprecated":null,"version":null,"openapi":"/openapi.json post /keys/create","href":"/api-reference/keys/create-api-key"},{"title":"List API keys","deprecated":null,"version":null,"openapi":"/openapi.json get /keys/list","href":"/api-reference/keys/list-api-keys"},{"title":"Revoke API key","deprecated":null,"version":null,"openapi":"/openapi.json post /keys/{id}/revoke","href":"/api-reference/keys/revoke-api-key"}]},{"group":"Spaces","pages":[{"title":"List spaces","deprecated":null,"version":null,"openapi":"/openapi.json get /spaces/list","href":"/api-reference/spaces/list-spaces"}]}]}]},"basePath":"","title":"Add dictionary words - OpenWhispr","buildId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","deploymentId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-DX1Meug0.js","utils-B_OMIQVC.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-ChxhRPMa.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CuKvD8Iv.js","snippetPresets-C5d7p2hp.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","Page-BAvA99GL.js","ApiExamples-CfHcE8m4.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C1zZV314.js","shallow-CmQhqCJn.js","getApiPlaygroundDisplay-YRo9s1O7.js","CodeSnippet-RN1MTdfk.js","CodeSnippets-DKLPHxJA.js","getPastedJson-bz0M41mU.js","icon-CsmhpPrv.js","MethodPill-CNGsVE77.js","DuplicateIcon-DilfU_Z2.js","createIcon-BdsYzQck.js","DynamicMarkdown-CbqEDjbV.js","SectionHeading-O6hXpFCN.js","axios-vUo_bRtp.js","Markdown-nKm-uidQ.js","clsx-ClVdStUn.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CIQkMg3R.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-ImrFS4Fy.js"]}