{
"message": "Invalid glossary entries provided",
"detail": "Key with the index 1 (starting at position 13) duplicates key with the index 0 (starting at position 0)"
}
{
"message": "Invalid glossary entries provided",
"detail": "Key with the index 1 (starting at position 13) duplicates key with the index 0 (starting at position 0)"
}
The function for creating a glossary returns a JSON object containing the ID of the newly created glossary and a boolean flag that indicates if the created glossary can already be used in translate requests.
The creation time of the glossary in the ISO 8601-1:2019 format (e.g.: 2021-08-03T14:16:18.329Z).
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"DeepL Documentation","description":"Developer documentation for the DeepL API: translate text and documents, transcribe and translate speech in real time, improve text, and customize output with glossaries, style rules, and translation memories.","colors":{"primary":"#0f2b46","light":"#ffffff","dark":"#0f2b46"},"logo":{"light":"https://mintcdn.com/deepl-c950b784/QiF37QSCmRj62dXZ/_assets/logo/light_with_text.svg?fit=max\u0026auto=format\u0026n=QiF37QSCmRj62dXZ\u0026q=85\u0026s=2dfc0d736effb479c0ac145abe2ab2c3","dark":"https://mintcdn.com/deepl-c950b784/QiF37QSCmRj62dXZ/_assets/logo/dark_with_text.svg?fit=max\u0026auto=format\u0026n=QiF37QSCmRj62dXZ\u0026q=85\u0026s=1c796b7a29370a15d010c5f6cda342f3"},"favicon":"https://mintcdn.com/deepl-c950b784/QiF37QSCmRj62dXZ/_assets/favicon.svg?fit=max\u0026auto=format\u0026n=QiF37QSCmRj62dXZ\u0026q=85\u0026s=b46ca099e325b1b5f0ce2f0fc351e394","api":{"openapi":"api-reference/openapi.yaml","asyncapi":"api-reference/voice/voice.asyncapi.yaml","playground":{"proxy":false},"examples":{"defaults":"required","languages":["curl"]}},"appearance":{"default":"light","strict":false},"background":{"color":{"light":"#ffffff"}},"navbar":{"links":[{"href":"https://www.deepl.com/en/pro#api","label":"Pricing"}],"primary":{"type":"button","label":"Free API Key","href":"https://www.deepl.com/en/checkout?is_api=true"}},"footer":{"socials":{"facebook":"https://www.facebook.com/DeepLcom","linkedin":"https://www.linkedin.com/company/deepl","github":"https://github.com/DeepL","instagram":"https://www.instagram.com/deeplhq"},"links":[{"items":[{"label":"API Status","href":"https://status.deepl.com/?tab=api"},{"label":"DeepL Status","href":"https://status.deepl.com"},{"label":"Contact","href":"/docs/resources/contact"}]}]},"seo":{"metatags":{"google-site-verification":"0VDGg3gJk53xL5burIUykHtV_eBhXTp5AMdzaeffbbU"},"organization":{"id":"https://www.deepl.com/","name":"DeepL","legalName":"DeepL SE","url":"https://www.deepl.com","logo":"https://static.deepl.com/img/logo/deepl-logo-blue.svg","sameAs":["https://github.com/DeepL","https://www.linkedin.com/company/deepl","https://x.com/DeepLcom","https://www.instagram.com/deeplhq/","https://www.youtube.com/@DeepLcom"]},"indexing":"navigable"},"fonts":{"heading":{"family":"Roboto"},"body":{"family":"Roboto"}},"integrations":{"cookies":{"key":"deepl_cookie_consent","value":"accepted"}},"banner":{"content":"Help shape the DeepL API roadmap. [Take the survey](https://deepl.qualtrics.com/jfe/form/SV_8fbjoZx1wQUkAC2)","dismissible":true},"errors":{"404":{"redirect":false,"title":"Page not found","description":"This page does not exist. Humans: check out the [Quickstart](/docs/getting-started/quickstart) or the [API reference](/api-reference/translate/request-translation). Machines: try [/llms.txt](/llms.txt), [the docs MCP server](https://developers.deepl.com/mcp), or OpenAPI specs for [Text](/api-reference/openapi.yaml) and [Voice](/api-reference/voice/voice.asyncapi.yaml)."}},"contextual":{"options":["copy","download-spec","chatgpt","claude","cursor","vscode"],"display":"header"},"markdown":{"instructions":["Use the DeepL API when a task needs machine translation or text improvement, including translating text strings, whole documents with formatting preservation, or transcribing and translating live speech. Preferred terminology and phrasing may be enforced using customizations (glossaries, style rules, and translation memories). Retrieve supported languages for each product from the `/v3/languages` endpoints.","Read the machine-readable API surface instead of inferring request shapes from prose: the REST spec is at https://developers.deepl.com/api-reference/openapi.yaml (also served as openapi.json) and the Voice WebSocket protocol is at https://developers.deepl.com/api-reference/voice/voice.asyncapi.yaml. These docs also expose an MCP server at https://developers.deepl.com/mcp (Streamable HTTP, no authentication).","Use https://api.deepl.com for Pro plans and https://api-free.deepl.com for the Free plan. Authenticate every request with the header `Authorization: DeepL-Auth-Key \u003capi-key>`. Never fabricate an API key: ask the user for one, or point them at https://developers.deepl.com/docs/getting-started/quickstart.","Errors use standard HTTP status codes with a JSON body containing a `message` field, plus a `code` field where available, and an `X-Trace-ID` response header that identifies the request in DeepL's logs. Log `X-Trace-ID` by default. Retry 429 and 5xx with exponential backoff. Do not retry 456, which means the account quota is exhausted, or 400, which means the request itself is invalid."]},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"deepl-c950b784","hasAudioNarration":false,"actualSubdomain":"deepl-c950b784","customDomains":["developers.deepl.com"],"gitSource":{"type":"github","owner":"deepl","repo":"api-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aeb5069245c712a705ad947","collectionId":"0c6847ce-cf56-4a74-9e91-1dfaa7903cc3","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aeb5069245c712a705ad947"},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"DISABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aeb5069245c712a705ad947","clientVersion":"0.0.4067","searchFilterCounts":[{"language":"default","tag":"API Reference","count":66},{"language":"default","tag":"Customize","count":55},{"language":"default","tag":"Home","count":35},{"language":"default","tag":"Translate","count":23},{"language":"default","tag":"Glossaries","count":17},{"language":"default","tag":"Admin","count":14},{"language":"default","tag":"Style Rules","count":12},{"language":"default","tag":"Spoken Terms","count":10},{"language":"default","tag":"Text Translation","count":10},{"language":"default","tag":"Voice","count":9}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"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}],"googleFontsInlined":true},"customCss":[{"filePath":"cookie-banner.css","content":"#cookie-banner{position:fixed;bottom:0;left:0;width:100%;background:#0f2b46;color:#fff;padding:20px;display:flex;justify-content:space-between;align-items:center;gap:20px;z-index:10000;box-shadow:0 -2px 10px rgba(0, 0, 0, 0.2);font-family:Roboto, sans-serif}#cookie-banner-content{flex:1}#cookie-banner-text{margin:0;font-size:14px;line-height:1.5}#cookie-banner-text a{color:#4FC3F7;text-decoration:underline}#cookie-banner-buttons{display:flex;gap:12px;flex-shrink:0}#cookie-reject,#cookie-accept{padding:10px 20px;border-radius:4px;cursor:pointer;font-size:14px;font-weight:500;transition:all 0.2s;font-family:Roboto, sans-serif}#cookie-reject{background:transparent;color:#fff;border:1px solid #fff}#cookie-reject:hover{background:rgba(255, 255, 255, 0.1)}#cookie-accept{background:#fff;color:#0f2b46;border:none}#cookie-accept:hover{background:#e6e6e6}@media (max-width: 768px){#cookie-banner{flex-direction:column;align-items:stretch;gap:16px;padding:16px}#cookie-banner-buttons{width:100%;justify-content:stretch}#cookie-reject,#cookie-accept{flex:1}}"},{"filePath":"user-study-popup.css","content":"#user-study-popup{position:fixed;right:24px;bottom:24px;z-index:9999;pointer-events:none;font-family:Roboto, sans-serif}#user-study-card{position:relative;width:360px;max-width:calc(100vw - 48px);padding:24px;background:#ffffff;border:1px solid rgba(15, 43, 70, 0.12);border-radius:16px;box-shadow:0 20px 45px rgba(15, 43, 70, 0.16), 0 6px 16px rgba(15, 43, 70, 0.1);pointer-events:auto;transform:translateX(calc(100% + 48px));transition:transform 0.35s ease}#user-study-card.slide-in{transform:translateX(0)}#user-study-card.slide-out{transform:translateX(calc(100% + 48px));transition:transform 0.25s ease-in}#user-study-close{position:absolute;top:12px;right:12px;display:flex;align-items:center;justify-content:center;width:32px;height:32px;padding:0;border:0;border-radius:999px;background:transparent;color:#6b7280;font-size:24px;line-height:1;cursor:pointer}#user-study-close:hover{background:rgba(15, 43, 70, 0.06);color:#0f2b46}#user-study-eyebrow{margin:0 0 8px;color:#0f2b46;font-size:12px;font-weight:700;letter-spacing:0.08em;text-transform:uppercase}#user-study-content h3{margin:0 28px 12px 0;color:#111827;font-size:22px;font-weight:700;line-height:1.2}#user-study-content p{margin:0 0 18px;color:#4b5563;font-size:14px;line-height:1.5}#user-study-cta{display:inline-flex;align-items:center;justify-content:center;width:100%;min-height:44px;border-radius:999px;background:#0f2b46;color:#ffffff;font-size:14px;font-weight:600;text-decoration:none}#user-study-cta:hover{background:#133858}@media (max-width: 480px){#user-study-popup{right:16px;bottom:16px;left:16px}#user-study-card{width:auto;max-width:none;padding:20px}#user-study-content h3{font-size:20px}}"},{"filePath":"navbar-cta.css","content":"html.dark #topbar-cta-button a>span:first-child{background-color:#FFFFFF!important}html.dark #topbar-cta-button a,html.dark #topbar-cta-button a span,html.dark #topbar-cta-button a svg{color:#292929!important}"}],"page":{"pagePath":"api-reference/multilingual-glossaries/create-a-glossary","slug":"/api-reference/multilingual-glossaries/create-a-glossary","pageMetadata":{"openapi":"post /v3/glossaries","title":"Create a glossary","description":"Create a v3 multilingual glossary holding one or more dictionaries, each covering a source and target language pair.","href":"/api-reference/multilingual-glossaries/create-a-glossary"},"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: \"Create a v3 multilingual glossary holding one or more dictionaries, each covering a source and target language pair.\"\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":{"openapi":"post /v3/glossaries","title":"Create a glossary","description":"Create a v3 multilingual glossary holding one or more dictionaries, each covering a source and target language pair.","href":"/api-reference/multilingual-glossaries/create-a-glossary"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/deepl-c950b784/79954643574228d7/analytics.js","/_mintlify/custom/deepl-c950b784/7c795428034ccd8b/cookie-banner.js","/_mintlify/custom/deepl-c950b784/e09568492714dd0f/user-study-popup.js","/_mintlify/custom/deepl-c950b784/06c83788a8296584/user-data.js"],"openApiReferenceData":{"operation":{"tags":["ManageMultilingualGlossaries"],"summary":"Create a Glossary","operationId":"createMultilingualGlossary","description":"Create a v3 multilingual glossary holding one or more dictionaries, each covering a source and target language pair.","requestBody":"18992cc2-1125-463d-b605-82d2f1326db7","responses":{"201":"733389eb-dd42-4258-ac62-1ce6bae365bc","400":"8b588fbe-5949-4dac-bc89-60416bf4cfb4","401":"792fb8e5-91a5-4581-a480-ffd7f67dc8b1","403":"ead34886-a944-404f-9831-ac55c60bb585","404":"e129d15e-3c3a-45e5-961f-f0b7d8dcab78","413":"60233028-12f5-4c55-a272-3622dd7c7bde","415":"dffd6850-4e0a-4e6b-95e7-f09f881b24a8","429":"6cd0a5a8-8c4d-446f-ac24-411245bfe8c8","456":"c59148d9-5c18-4755-b310-5cddf2eefc74","500":"4c79d83e-cebd-411a-885c-54fc278a038a","503":"ca6a1f48-113e-4b93-b9f7-ca73c7ee679d","529":"1088c371-56a1-4c91-adde-f059b766488a"},"security":["16d57270-7937-42f1-ac4e-c49244945822"],"method":"post","type":"path","servers":["c4615c24-7d01-4e83-8ecc-9651dbe481cb","6eea3424-eb39-4207-bfbe-da2fb90a9e9c"],"path":"/v3/glossaries","baseUrlOptions":["https://api.deepl.com","https://api-free.deepl.com"],"title":"Create a Glossary","codeSamples":[],"requestExampleLanguages":["bash"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","disableProxy":true},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name","dictionaries"],"properties":{"name":{"description":"Name to be associated with the glossary.","type":"string","example":"My Glossary","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"dictionaries":{"description":"Dictionaries to populate the glossary with.","type":"array","items":{"type":"object","description":"A dictionary contained in a multilingual glossary. Each dictionary contains the mapping of source terms to target language terms.","properties":{"source_lang":{"type":"string","description":"The language in which the source texts in the glossary are specified.","enum":["ar","bg","cs","da","de","el","en","es","et","fi","fr","he","hu","id","it","ja","ko","lt","lv","nb","nl","pl","pt","ro","ru","sk","sl","sv","tr","uk","vi","zh"],"example":"en","uniqueKey":"dictionaries.items.[INDEX].source_lang","typeLabel":"enum\u003cstring>"},"target_lang":{"type":"string","description":"The language in which the target texts in the dictionary are specified. Besides the base languages, the\ntarget can be one of these variants: `de-CH`, `de-DE`, `en-GB`, `en-US`, `es-419`, `es-ES`, `fr-CA`,\n`fr-FR`, `pt-BR`, `pt-PT`, `zh-Hans`, or `zh-Hant`. Source languages are always base languages. The current\nlist is returned by `GET /v3/languages?resource=glossary`.\n\nA dictionary with a base target, such as `de`, applies when translating into that language and any of its\nvariants. A dictionary with a variant target, such as `de-CH`, applies only when translating into that\nexact variant.\n\nWithin one glossary, each language family uses either the base language or its variants as targets, not\nboth. For example, `de-CH` and `de-DE` can be combined, but `de` and `de-DE` cannot. Adding a dictionary\nthat breaks this rule returns a 400 error.","enum":["ar","bg","cs","da","de","de-CH","de-DE","el","en","en-GB","en-US","es","es-419","es-ES","et","fi","fr","fr-CA","fr-FR","he","hu","id","it","ja","ko","lt","lv","nb","nl","pl","pt","pt-BR","pt-PT","ro","ru","sk","sl","sv","tr","uk","vi","zh","zh-Hans","zh-Hant"],"example":"de","uniqueKey":"dictionaries.items.[INDEX].target_lang","typeLabel":"enum\u003cstring>"},"entries":{"type":"string","description":"The entries of the glossary. The entries have to be specified in the format provided by the `entries_format` parameter.","example":"Hello\tGuten Tag","uniqueKey":"dictionaries.items.[INDEX].entries","typeLabel":"string"},"entries_format":{"description":"The format in which the glossary entries are provided. Formats currently available:\n- `tsv` (default) - tab-separated values\n- `csv` - comma-separated values\n\nSee [Supported Glossary Formats](/docs/customize/managing-glossaries#entry-formats) for details about each format.","type":"string","enum":["tsv","csv"],"example":"tsv","default":"tsv","uniqueKey":"dictionaries.items.[INDEX].entries_format","typeLabel":"enum\u003cstring>"}},"uniqueKey":"dictionaries.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"dictionaries","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Basic":{"title":"Basic","value":{"name":"My Glossary","dictionaries":[{"source_lang":"en","target_lang":"de","entries":"Hello\tGuten Tag","entries_format":"tsv"},{"source_lang":"de","target_lang":"en","entries":"Guten Tag\tHello","entries_format":"tsv"}]}}},"exampleType":"examples"},"application/x-www-form-urlencoded":{"schema":{"type":"object","required":["name","dictionaries"],"properties":{"name":{"description":"Name to be associated with the glossary.","type":"string","example":"My Glossary","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"dictionaries":{"description":"Dictionaries to populate the glossary with.","type":"array","items":{"type":"object","description":"A dictionary contained in a multilingual glossary. Each dictionary contains the mapping of source terms to target language terms.","properties":{"source_lang":{"type":"string","description":"The language in which the source texts in the glossary are specified.","enum":["ar","bg","cs","da","de","el","en","es","et","fi","fr","he","hu","id","it","ja","ko","lt","lv","nb","nl","pl","pt","ro","ru","sk","sl","sv","tr","uk","vi","zh"],"example":"en","uniqueKey":"dictionaries.items.[INDEX].source_lang","typeLabel":"enum\u003cstring>"},"target_lang":{"type":"string","description":"The language in which the target texts in the dictionary are specified. Besides the base languages, the\ntarget can be one of these variants: `de-CH`, `de-DE`, `en-GB`, `en-US`, `es-419`, `es-ES`, `fr-CA`,\n`fr-FR`, `pt-BR`, `pt-PT`, `zh-Hans`, or `zh-Hant`. Source languages are always base languages. The current\nlist is returned by `GET /v3/languages?resource=glossary`.\n\nA dictionary with a base target, such as `de`, applies when translating into that language and any of its\nvariants. A dictionary with a variant target, such as `de-CH`, applies only when translating into that\nexact variant.\n\nWithin one glossary, each language family uses either the base language or its variants as targets, not\nboth. For example, `de-CH` and `de-DE` can be combined, but `de` and `de-DE` cannot. Adding a dictionary\nthat breaks this rule returns a 400 error.","enum":["ar","bg","cs","da","de","de-CH","de-DE","el","en","en-GB","en-US","es","es-419","es-ES","et","fi","fr","fr-CA","fr-FR","he","hu","id","it","ja","ko","lt","lv","nb","nl","pl","pt","pt-BR","pt-PT","ro","ru","sk","sl","sv","tr","uk","vi","zh","zh-Hans","zh-Hant"],"example":"de","uniqueKey":"dictionaries.items.[INDEX].target_lang","typeLabel":"enum\u003cstring>"},"entries":{"type":"string","description":"The entries of the glossary. The entries have to be specified in the format provided by the `entries_format` parameter.","example":"Hello\tGuten Tag","uniqueKey":"dictionaries.items.[INDEX].entries","typeLabel":"string"},"entries_format":{"description":"The format in which the glossary entries are provided. Formats currently available:\n- `tsv` (default) - tab-separated values\n- `csv` - comma-separated values\n\nSee [Supported Glossary Formats](/docs/customize/managing-glossaries#entry-formats) for details about each format.","type":"string","enum":["tsv","csv"],"example":"tsv","default":"tsv","uniqueKey":"dictionaries.items.[INDEX].entries_format","typeLabel":"enum\u003cstring>"}},"uniqueKey":"dictionaries.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"dictionaries","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"name":"My Glossary","dictionaries":[{"source_lang":"en","target_lang":"de","entries":"Hello\tGuten Tag","entries_format":"tsv"}]}}},"exampleType":"generated"}},"exampleType":"examples"},"responses":{"733389eb-dd42-4258-ac62-1ce6bae365bc":{"description":"The function for creating a glossary returns a JSON object containing the ID of the newly created glossary and a boolean flag that indicates if the created glossary can already be used in translate requests.","headers":{"X-Trace-ID":{"description":"A unique identifier for the request that can be included in bug reports to DeepL support.","schema":{"type":"string"},"example":"501c3d93cc0c4f11ae2f60a226c2f0f0"}},"content":{"application/json":{"schema":{"type":"object","properties":{"glossary_id":{"type":"string","description":"A unique ID assigned to a glossary.","example":"def3a26b-3e84-45b3-84ae-0c0aaf3525f7","uniqueKey":"glossary_id","typeLabel":"string"},"name":{"description":"Name associated with the glossary.","type":"string","uniqueKey":"name","typeLabel":"string"},"dictionaries":{"description":"List of dictionaries contained in this glossary.\nEach dictionary contains a source and target language, as well as pairs of source and target entries.","type":"array","items":{"type":"object","description":"A dictionary contained in a multilingual glossary. Each dictionary contains the mapping of source terms to target language terms.","properties":{"source_lang":{"type":"string","description":"The language in which the source texts in the glossary are specified.","enum":["ar","bg","cs","da","de","el","en","es","et","fi","fr","he","hu","id","it","ja","ko","lt","lv","nb","nl","pl","pt","ro","ru","sk","sl","sv","tr","uk","vi","zh"],"example":"en","uniqueKey":"dictionaries.items.[INDEX].source_lang","typeLabel":"enum\u003cstring>"},"target_lang":{"type":"string","description":"The language in which the target texts in the dictionary are specified. Besides the base languages, the\ntarget can be one of these variants: `de-CH`, `de-DE`, `en-GB`, `en-US`, `es-419`, `es-ES`, `fr-CA`,\n`fr-FR`, `pt-BR`, `pt-PT`, `zh-Hans`, or `zh-Hant`. Source languages are always base languages. The current\nlist is returned by `GET /v3/languages?resource=glossary`.\n\nA dictionary with a base target, such as `de`, applies when translating into that language and any of its\nvariants. A dictionary with a variant target, such as `de-CH`, applies only when translating into that\nexact variant.\n\nWithin one glossary, each language family uses either the base language or its variants as targets, not\nboth. For example, `de-CH` and `de-DE` can be combined, but `de` and `de-DE` cannot. Adding a dictionary\nthat breaks this rule returns a 400 error.","enum":["ar","bg","cs","da","de","de-CH","de-DE","el","en","en-GB","en-US","es","es-419","es-ES","et","fi","fr","fr-CA","fr-FR","he","hu","id","it","ja","ko","lt","lv","nb","nl","pl","pt","pt-BR","pt-PT","ro","ru","sk","sl","sv","tr","uk","vi","zh","zh-Hans","zh-Hant"],"example":"de","uniqueKey":"dictionaries.items.[INDEX].target_lang","typeLabel":"enum\u003cstring>"},"entries":{"type":"string","description":"The entries of the glossary. The entries have to be specified in the format provided by the `entries_format` parameter.","example":"Hello\tGuten Tag","uniqueKey":"dictionaries.items.[INDEX].entries","typeLabel":"string"},"entries_format":{"description":"The format in which the glossary entries are provided. Formats currently available:\n- `tsv` (default) - tab-separated values\n- `csv` - comma-separated values\n\nSee [Supported Glossary Formats](/docs/customize/managing-glossaries#entry-formats) for details about each format.","type":"string","enum":["tsv","csv"],"example":"tsv","default":"tsv","uniqueKey":"dictionaries.items.[INDEX].entries_format","typeLabel":"enum\u003cstring>"},"entry_count":{"type":"integer","description":"The number of entries in the glossary.","uniqueKey":"dictionaries.items.[INDEX].entry_count","typeLabel":"integer"}},"uniqueKey":"dictionaries.items.[INDEX]","typeLabel":"object"},"uniqueKey":"dictionaries","typeLabel":"object[]"},"creation_time":{"description":"The creation time of the glossary in the ISO 8601-1:2019 format (e.g.: `2021-08-03T14:16:18.329Z`).","type":"string","format":"date-time","uniqueKey":"creation_time","typeLabel":"string\u003cdate-time>"}},"example":{"glossary_id":"def3a26b-3e84-45b3-84ae-0c0aaf3525f7","name":"My Glossary","dictionaries":[{"source_lang":"en","target_lang":"de","entry_count":1}],"creation_time":"2021-08-03T14:16:18.329Z"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"glossary_id":"def3a26b-3e84-45b3-84ae-0c0aaf3525f7","name":"My Glossary","dictionaries":[{"source_lang":"en","target_lang":"de","entry_count":1}],"creation_time":"2021-08-03T14:16:18.329Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"8b588fbe-5949-4dac-bc89-60416bf4cfb4":{"description":"Bad request. Please check error message and your parameters.","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"description":"Generic description of the error.","type":"string","uniqueKey":"message","typeLabel":"string"},"detail":{"description":"More specific description of the error.","type":"string","uniqueKey":"detail","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"message":"Invalid glossary entries provided","detail":"Key with the index 1 (starting at position 13) duplicates key with the index 0 (starting at position 0)"},"examples":{"Example":{"title":"Example","value":{"message":"Invalid glossary entries provided","detail":"Key with the index 1 (starting at position 13) duplicates key with the index 0 (starting at position 0)"}}},"exampleType":"examples"}},"exampleType":"examples"},"792fb8e5-91a5-4581-a480-ffd7f67dc8b1":{"description":"Authorization failed. Please supply a valid `DeepL-Auth-Key` via the `Authorization` header.","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"A human-readable description of the error.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"A machine-readable identifier for the error, when available. Clients should match on this value rather than on `message` when branching on error types.","example":"invalid_content_type","uniqueKey":"code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","code":"invalid_content_type"}}},"exampleType":"generated"}},"exampleType":"generated"},"ead34886-a944-404f-9831-ac55c60bb585":{"description":"Forbidden. The access to the requested resource is denied, because of insufficient access rights. This error is also returned when the API key is scoped but does not include the scope required for this endpoint.","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"A human-readable description of the error.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"A machine-readable identifier for the error, when available. Clients should match on this value rather than on `message` when branching on error types.","example":"invalid_content_type","uniqueKey":"code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","code":"invalid_content_type"}}},"exampleType":"generated"}},"exampleType":"generated"},"e129d15e-3c3a-45e5-961f-f0b7d8dcab78":{"description":"The requested resource could not be found.","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"A human-readable description of the error.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"A machine-readable identifier for the error, when available. Clients should match on this value rather than on `message` when branching on error types.","example":"invalid_content_type","uniqueKey":"code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","code":"invalid_content_type"}}},"exampleType":"generated"}},"exampleType":"generated"},"60233028-12f5-4c55-a272-3622dd7c7bde":{"description":"The request size exceeds the limit.","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"A human-readable description of the error.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"A machine-readable identifier for the error, when available. Clients should match on this value rather than on `message` when branching on error types.","example":"invalid_content_type","uniqueKey":"code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","code":"invalid_content_type"}}},"exampleType":"generated"}},"exampleType":"generated"},"dffd6850-4e0a-4e6b-95e7-f09f881b24a8":{"description":"The requested entries format specified in the `Accept` header is not supported.","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"A human-readable description of the error.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"A machine-readable identifier for the error, when available. Clients should match on this value rather than on `message` when branching on error types.","example":"invalid_content_type","uniqueKey":"code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","code":"invalid_content_type"}}},"exampleType":"generated"}},"exampleType":"generated"},"6cd0a5a8-8c4d-446f-ac24-411245bfe8c8":{"description":"Too many requests. Please wait and resend your request.","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"A human-readable description of the error.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"A machine-readable identifier for the error, when available. Clients should match on this value rather than on `message` when branching on error types.","example":"invalid_content_type","uniqueKey":"code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","code":"invalid_content_type"}}},"exampleType":"generated"}},"exampleType":"generated"},"c59148d9-5c18-4755-b310-5cddf2eefc74":{"description":"Quota exceeded. Too many requests were made to the glossary endpoints recently.","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"A human-readable description of the error.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"A machine-readable identifier for the error, when available. Clients should match on this value rather than on `message` when branching on error types.","example":"invalid_content_type","uniqueKey":"code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","code":"invalid_content_type"}}},"exampleType":"generated"}},"exampleType":"generated"},"4c79d83e-cebd-411a-885c-54fc278a038a":{"description":"Internal error.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"A human-readable description of the error.","isRequired":true,"uniqueKey":"oneOf.0.message","typeLabel":"string"},"code":{"type":"string","description":"A machine-readable identifier for the error, when available. Clients should match on this value rather than on `message` when branching on error types.","example":"invalid_content_type","uniqueKey":"oneOf.0.code","typeLabel":"string"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","description":"Error body returned by DeepL's edge infrastructure for failures that occur before a request reaches the API itself. The message is nested under `error`, unlike the application-level `ErrorResponse`. Clients that parse error bodies should handle both shapes.\n","required":["error"],"properties":{"error":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"A human-readable description of the error.","example":"Bad Gateway.","isRequired":true,"uniqueKey":"oneOf.1.error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"oneOf.1.error","typeLabel":"object"}},"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","code":"invalid_content_type"}}},"exampleType":"generated"}},"exampleType":"generated"},"ca6a1f48-113e-4b93-b9f7-ca73c7ee679d":{"description":"Resource currently unavailable. Try again later.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"A human-readable description of the error.","isRequired":true,"uniqueKey":"oneOf.0.message","typeLabel":"string"},"code":{"type":"string","description":"A machine-readable identifier for the error, when available. Clients should match on this value rather than on `message` when branching on error types.","example":"invalid_content_type","uniqueKey":"oneOf.0.code","typeLabel":"string"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","description":"Error body returned by DeepL's edge infrastructure for failures that occur before a request reaches the API itself. The message is nested under `error`, unlike the application-level `ErrorResponse`. Clients that parse error bodies should handle both shapes.\n","required":["error"],"properties":{"error":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"A human-readable description of the error.","example":"Bad Gateway.","isRequired":true,"uniqueKey":"oneOf.1.error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"oneOf.1.error","typeLabel":"object"}},"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","code":"invalid_content_type"}}},"exampleType":"generated"}},"exampleType":"generated"},"1088c371-56a1-4c91-adde-f059b766488a":{"description":"Too many requests. Please wait and resend your request.","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"A human-readable description of the error.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"A machine-readable identifier for the error, when available. Clients should match on this value rather than on `message` when branching on error types.","example":"invalid_content_type","uniqueKey":"code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","code":"invalid_content_type"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"16d57270-7937-42f1-ac4e-c49244945822":{"auth_header":{"type":"apiKey","description":"Authentication with `Authorization` header and `DeepL-Auth-Key` authentication scheme. Example: `DeepL-Auth-Key \u003capi-key>`\n","name":"Authorization","in":"header","x-default":"DeepL-Auth-Key ","scopes":[],"schemeName":"auth_header"}}},"servers":{"c4615c24-7d01-4e83-8ecc-9651dbe481cb":{"url":"https://api.deepl.com","description":"DeepL API Pro"},"6eea3424-eb39-4207-bfbe-da2fb90a9e9c":{"url":"https://api-free.deepl.com","description":"DeepL API Free"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","description":"Authentication with `Authorization` header and `DeepL-Auth-Key` authentication scheme. Example: `DeepL-Auth-Key \u003capi-key>`\n","name":"Authorization","in":"header","x-default":"DeepL-Auth-Key ","scopes":[],"schemeName":"auth_header"},"schema":{"title":"Authorization","type":"string","description":"Authentication with `Authorization` header and `DeepL-Auth-Key` authentication scheme. Example: `DeepL-Auth-Key \u003capi-key>`\n","isRequired":true,"default":"DeepL-Auth-Key ","typeLabel":"string","deprecated":false},"schemeName":"auth_header","name":"Authorization"}],"title":"auth_header"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"deepl-c950b784","siteName":"DeepL Documentation","title":"Create a glossary - DeepL Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-10T08:55:23.382Z","originalFileLocation":"api-reference/multilingual-glossaries/create-a-glossary.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=\"light\"}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=\"Create a v3 multilingual glossary holding one or more dictionaries, each covering a source and target language pair.\">\u003cmeta data-mint-head name=\"application-name\" content=\"DeepL Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/deepl-c950b784/hSlhr1iEcolF1mhS/_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/deepl-c950b784/hSlhr1iEcolF1mhS/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/deepl-c950b784/hSlhr1iEcolF1mhS/_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/deepl-c950b784/hSlhr1iEcolF1mhS/_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/deepl-c950b784/hSlhr1iEcolF1mhS/_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/deepl-c950b784/hSlhr1iEcolF1mhS/_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/deepl-c950b784/hSlhr1iEcolF1mhS/_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/deepl-c950b784/hSlhr1iEcolF1mhS/_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/deepl-c950b784/hSlhr1iEcolF1mhS/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a glossary - DeepL Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a v3 multilingual glossary holding one or more dictionaries, each covering a source and target language pair.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"DeepL Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.deepl.com/api-reference/multilingual-glossaries/create-a-glossary\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://deepl-c950b784.mintlify.app/_mintlify/api/og/v2?division=Glossaries\u0026amp;title=Create+a+glossary\u0026amp;description=Create+a+v3+multilingual+glossary+holding+one+or+more+dictionaries%2C+each+covering+a+source+and+target+language+pair.\u0026amp;theme=a0c51edccdcaa2c1bb0516c1\u0026amp;signature=2d5bc8f4ec04eef9328bd034b942f48bbaa594cc84aed4d924808e788cc5ce04\">\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=\"Create a glossary - DeepL Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a v3 multilingual glossary holding one or more dictionaries, each covering a source and target language pair.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://deepl-c950b784.mintlify.app/_mintlify/api/og/v2?division=Glossaries\u0026amp;title=Create+a+glossary\u0026amp;description=Create+a+v3+multilingual+glossary+holding+one+or+more+dictionaries%2C+each+covering+a+source+and+target+language+pair.\u0026amp;theme=a0c51edccdcaa2c1bb0516c1\u0026amp;signature=2d5bc8f4ec04eef9328bd034b942f48bbaa594cc84aed4d924808e788cc5ce04\">\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/deepl-c950b784/hSlhr1iEcolF1mhS/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"DeepL Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0f2b46\">\u003cmeta data-mint-head name=\"google-site-verification\" content=\"0VDGg3gJk53xL5burIUykHtV_eBhXTp5AMdzaeffbbU\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers.deepl.com/api-reference/multilingual-glossaries/create-a-glossary\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/multilingual-glossaries/create-a-glossary.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.deepl.com/\",\"name\":\"DeepL\",\"legalName\":\"DeepL SE\",\"url\":\"https://www.deepl.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://static.deepl.com/img/logo/deepl-logo-blue.svg\"},\"sameAs\":[\"https://github.com/DeepL\",\"https://www.linkedin.com/company/deepl\",\"https://x.com/DeepLcom\",\"https://www.instagram.com/deeplhq/\",\"https://www.youtube.com/@DeepLcom\"]},{\"@type\":\"WebSite\",\"@id\":\"https://developers.deepl.com#website\",\"name\":\"DeepL Documentation\",\"url\":\"https://developers.deepl.com\",\"publisher\":{\"@id\":\"https://www.deepl.com/\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers.deepl.com/api-reference/multilingual-glossaries/create-a-glossary#webpage\",\"url\":\"https://developers.deepl.com/api-reference/multilingual-glossaries/create-a-glossary\",\"name\":\"Create a glossary\",\"description\":\"Create a v3 multilingual glossary holding one or more dictionaries, each covering a source and target language pair.\",\"dateModified\":\"2026-09-10T08:55:23.382Z\",\"isPartOf\":{\"@id\":\"https://developers.deepl.com#website\"},\"breadcrumb\":{\"@id\":\"https://developers.deepl.com/api-reference/multilingual-glossaries/create-a-glossary#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.deepl.com/api-reference/multilingual-glossaries/create-a-glossary#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"DeepL Documentation\",\"item\":\"https://developers.deepl.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create a glossary\",\"item\":\"https://developers.deepl.com/api-reference/multilingual-glossaries/create-a-glossary\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developers.deepl.com/api-reference/multilingual-glossaries/create-a-glossary#apireference\",\"headline\":\"Create a glossary\",\"name\":\"Create a glossary\",\"description\":\"Create a v3 multilingual glossary holding one or more dictionaries, each covering a source and target language pair.\",\"url\":\"https://developers.deepl.com/api-reference/multilingual-glossaries/create-a-glossary\",\"mainEntityOfPage\":{\"@id\":\"https://developers.deepl.com/api-reference/multilingual-glossaries/create-a-glossary#webpage\"},\"dateModified\":\"2026-09-10T08:55:23.382Z\",\"publisher\":{\"@id\":\"https://www.deepl.com/\"},\"isPartOf\":{\"@id\":\"https://developers.deepl.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"DeepL Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"DeepL Documentation","nav":{"global":null,"tabs":[{"tab":"Home","icon":"house","pages":[{"title":"Home","href":"/docs/getting-started/quickstart"}]},{"tab":"Translate","icon":"language","pages":[{"title":"Translate","href":"/docs/translate/overview"}]},{"tab":"Voice","icon":"waveform-lines","pages":[{"title":"Voice","href":"/docs/voice/overview"}]},{"tab":"Customize","icon":"wand-magic-sparkles","pages":[{"title":"Customize","href":"/docs/customize/overview"}]},{"tab":"Admin","icon":"sliders","pages":[{"title":"Admin","href":"/docs/admin/overview"}]},{"tab":"API Reference","icon":"code","groups":[{"group":"Translate","pages":[{"group":"Translate Text","pages":[{"openapi":"post /v2/translate","title":"Translate text","href":"/api-reference/translate/request-translation"}]},{"group":"Translate Documents","pages":[{"openapi":"post /v2/document","title":"Upload and translate a document","href":"/api-reference/document/upload-and-translate-a-document"},{"openapi":"post /v2/document/{document_id}","title":"Check document status","href":"/api-reference/document/check-document-status"},{"openapi":"post /v2/document/{document_id}/result","title":"Download translated document","href":"/api-reference/document/download-translated-document"}]},{"group":"Quality Evaluation","tag":"BETA","pages":[{"openapi":"get /v1/quality-evaluations/{job_id}","tag":"BETA","title":"Poll for the evaluation result","href":"/api-reference/quality-evaluations/poll"}]},{"group":"Write","pages":[{"openapi":"post /v2/write/rephrase","title":"Improve text","href":"/api-reference/improve-text/request-text-improvement"},{"openapi":"post /v2/write/correct","title":"Correct text","href":"/api-reference/improve-text/correct-text"}]},{"title":"Detect Language","tag":"BETA","description":"Detect the language of text using DeepL's language detection service","href":"/api-reference/detect-language/detect-language-beta"}]},{"group":"Customize","pages":[{"group":"Glossaries","pages":[{"openapi":"post /v3/glossaries","title":"Create a glossary","href":"/api-reference/multilingual-glossaries/create-a-glossary"},{"openapi":"get /v3/glossaries","title":"List all glossaries","description":"List every v3 multilingual glossary on your account with its metadata, without returning the entries.","href":"/api-reference/multilingual-glossaries/list-all-glossaries"},{"openapi":"get /v3/glossaries/{glossary_id}","title":"Retrieve glossary details","href":"/api-reference/multilingual-glossaries/retrieve-glossary-details"},{"openapi":"patch /v3/glossaries/{glossary_id}","title":"Edit glossary details","href":"/api-reference/multilingual-glossaries/edit-glossary-details"},{"openapi":"get /v3/glossaries/{glossary_id}/entries","title":"Retrieve glossary entries","href":"/api-reference/multilingual-glossaries/retrieve-glossary-entries"},{"openapi":"delete /v3/glossaries/{glossary_id}","title":"Delete a glossary","href":"/api-reference/multilingual-glossaries/delete-a-glossary"},{"openapi":"delete /v3/glossaries/{glossary_id}/dictionaries","sidebarTitle":"Delete a glossary dictionary","title":"Deletes the dictionary associated with the given language pair with the given glossary ID.","href":"/api-reference/multilingual-glossaries/deletes-the-dictionary-associated-with-the-given-language-pair-with-the-given-glossary-id"},{"openapi":"put /v3/glossaries/{glossary_id}/dictionaries","sidebarTitle":"Create or replace glossary entries","title":"Replaces or creates a dictionary in the glossary with the specified entries.","href":"/api-reference/multilingual-glossaries/replaces-or-creates-a-dictionary-in-the-glossary-with-the-specified-entries"},{"group":"Glossaries v2","tag":"DEPRECATED","pages":[{"openapi":"get /v2/glossary-language-pairs","title":"List language pairs supported for glossaries","tag":"DEPRECATED","playground":"none","href":"/api-reference/multilingual-glossaries/list-language-pairs-supported-by-glossaries"},{"openapi":"post /v2/glossaries","title":"Create a glossary","playground":"none","href":"/api-reference/glossaries/create-a-glossary"},{"openapi":"get /v2/glossaries","title":"List all glossaries","playground":"none","href":"/api-reference/glossaries/list-all-glossaries"},{"openapi":"get /v2/glossaries/{glossary_id}","title":"Retrieve glossary details","playground":"none","href":"/api-reference/glossaries/retrieve-glossary-details"},{"openapi":"get /v2/glossaries/{glossary_id}/entries","title":"Retrieve glossary entries","playground":"none","href":"/api-reference/glossaries/retrieve-glossary-entries"},{"openapi":"delete /v2/glossaries/{glossary_id}","title":"Delete a glossary","playground":"none","href":"/api-reference/glossaries/delete-a-glossary"}]}]},{"group":"Spoken Terms","pages":[{"openapi":"post /v3/spoken-terms","title":"Create Spoken Terms collection","href":"/api-reference/spoken-terms/create-spoken-terms-collection"},{"openapi":"get /v3/spoken-terms","title":"List all Spoken Terms collections","href":"/api-reference/spoken-terms/list-all-spoken-terms"},{"openapi":"get /v3/spoken-terms/{spoken_terms_id}","title":"Retrieve Spoken Terms collection details","href":"/api-reference/spoken-terms/retrieve-spoken-terms-details"},{"openapi":"patch /v3/spoken-terms/{spoken_terms_id}","title":"Edit Spoken Terms collection details","href":"/api-reference/spoken-terms/edit-spoken-terms-details"},{"openapi":"get /v3/spoken-terms/{spoken_terms_id}/entries","title":"Retrieve Spoken Terms entries","href":"/api-reference/spoken-terms/retrieve-spoken-terms-entries"},{"openapi":"delete /v3/spoken-terms/{spoken_terms_id}","title":"Delete Spoken Terms collection","href":"/api-reference/spoken-terms/delete-spoken-terms"},{"openapi":"delete /v3/spoken-terms/{spoken_terms_id}/term-lists","title":"Delete a term list","href":"/api-reference/spoken-terms/delete-spoken-terms-list"},{"openapi":"put /v3/spoken-terms/{spoken_terms_id}/term-lists","title":"Replace or create a term list","href":"/api-reference/spoken-terms/replace-or-create-term-list"}]},{"group":"Style Profiles","pages":[{"openapi":"get /v3/style_profiles","title":"List style profiles","href":"/api-reference/style-profiles/list-all-style-profiles"},{"openapi":"post /v3/style_profiles","title":"Create a style profile","href":"/api-reference/style-profiles/create-style-profile"},{"openapi":"get /v3/style_profiles/{style_profile_id}","title":"Retrieve a style profile","href":"/api-reference/style-profiles/get-style-profile"},{"openapi":"patch /v3/style_profiles/{style_profile_id}","title":"Update a style profile","href":"/api-reference/style-profiles/update-style-profile"},{"openapi":"delete /v3/style_profiles/{style_profile_id}","title":"Delete a style profile","href":"/api-reference/style-profiles/delete-style-profile"}]},{"group":"Style Rules","pages":[{"openapi":"get /v3/style_rules","title":"Get all style rule lists","href":"/api-reference/style-rules/list-all-style-rules"},{"openapi":"post /v3/style_rules","title":"Create a style rule list","href":"/api-reference/style-rules/create-style-rule"},{"openapi":"get /v3/style_rules/{style_id}","title":"Get a style rule list","href":"/api-reference/style-rules/get-style-rule"},{"openapi":"patch /v3/style_rules/{style_id}","title":"Update a style rule list's name","href":"/api-reference/style-rules/update-style-rule"},{"openapi":"put /v3/style_rules/{style_id}/configured_rules","title":"Replace configured rules","href":"/api-reference/style-rules/update-configured-rules"},{"openapi":"delete /v3/style_rules/{style_id}","title":"Delete a style rule list","href":"/api-reference/style-rules/delete-style-rule"},{"openapi":"post /v3/style_rules/{style_id}/custom_instructions","title":"Create a custom instruction","href":"/api-reference/style-rules/create-custom-instruction"},{"openapi":"get /v3/style_rules/{style_id}/custom_instructions/{instruction_id}","title":"Get a custom instruction","href":"/api-reference/style-rules/get-custom-instruction"},{"openapi":"put /v3/style_rules/{style_id}/custom_instructions/{instruction_id}","title":"Replace a custom instruction","href":"/api-reference/style-rules/update-custom-instruction"},{"openapi":"delete /v3/style_rules/{style_id}/custom_instructions/{instruction_id}","title":"Delete a custom instruction","href":"/api-reference/style-rules/delete-custom-instruction"}]},{"group":"Translation Memory","pages":[{"openapi":"get /v3/translation_memories","title":"List translation memories","href":"/api-reference/translation-memory/list-translation-memories"},{"openapi":"get /v3/translation_memories/{translation_memory_id}","title":"Retrieve a translation memory","href":"/api-reference/translation-memory/retrieve-a-translation-memory"},{"openapi":"get /v3/translation_memories/{translation_memory_id}/segments","title":"List translation memory segments","href":"/api-reference/translation-memory/list-translation-memory-segments"},{"openapi":"post /v3/translation_memories/import","title":"Import a translation memory","href":"/api-reference/translation-memory/import-a-translation-memory"},{"openapi":"post /v3/translation_memories/{translation_memory_id}/export","title":"Export a translation memory","href":"/api-reference/translation-memory/export-a-translation-memory"},{"openapi":"get /v3/translation_memories/jobs/{job_id}","title":"Retrieve an import or export job","href":"/api-reference/translation-memory/retrieve-a-translation-memory-job"},{"openapi":"delete /v3/translation_memories/{translation_memory_id}","title":"Delete a translation memory","href":"/api-reference/translation-memory/delete-a-translation-memory"}]}]},{"group":"Voice","pages":[{"group":"Real-Time","pages":[{"openapi":"post /v3/voice/realtime","title":"Request Session","href":"/api-reference/voice/request-session"},{"asyncapi":"voiceStream","title":"WebSocket Streaming","href":"/api-reference/voice/websocket-streaming"},{"openapi":"get /v3/voice/realtime","title":"Reconnect Session","href":"/api-reference/voice/reconnect-session"}]}]},{"group":"Translate Audio Files","hidden":true,"pages":[{"title":"Translate Audio Files","sidebarTitle":"Overview","href":"/api-reference/jobs-voice-translate"},{"openapi":"post /v1/jobs/voice/translate","title":"Create a voice translation job","href":"/api-reference/jobs-voice-translate/create-voice-translate-job"},{"openapi":"get /v1/jobs/voice/translate/{job_id}","title":"Get voice translation job status","href":"/api-reference/jobs-voice-translate/get-voice-translate-job-status"},{"title":"Reference","sidebarTitle":"Reference","href":"/api-reference/jobs-voice-translate/reference"}]},{"group":"Languages","pages":[{"group":"Languages v3","pages":[{"openapi":"get /v3/languages","title":"Retrieve languages","href":"/api-reference/languages/retrieve-languages-by-resource"},{"openapi":"get /v3/languages/resources","title":"Retrieve language resources","href":"/api-reference/languages/retrieve-resources"}]},{"group":"Languages v2","tag":"DEPRECATED","pages":[{"openapi":"get /v2/languages","title":"Retrieve supported languages (v2)","tag":"DEPRECATED","href":"/api-reference/languages/retrieve-supported-languages"}]}]},{"group":"Admin","pages":[{"group":"Managing Developer Keys","pages":[{"openapi":"post /v2/admin/developer-keys","title":"Create a developer key","href":"/api-reference/admin-api/managing-developer-keys/create-key"},{"openapi":"get /v2/admin/developer-keys","title":"Get developer keys","href":"/api-reference/admin-api/managing-developer-keys/get-keys"},{"openapi":"put /v2/admin/developer-keys/deactivate","title":"Deactivate a developer key","href":"/api-reference/admin-api/managing-developer-keys/deactivate-key"},{"openapi":"put /v2/admin/developer-keys/label","title":"Rename a developer key","href":"/api-reference/admin-api/managing-developer-keys/rename-key"},{"openapi":"put /v2/admin/developer-keys/limits","title":"Set developer key limits","href":"/api-reference/admin-api/managing-developer-keys/set-usage-limits"}]},{"group":"Usage \u0026 Quota","pages":[{"openapi":"get /v2/usage","title":"Check usage and limits","href":"/api-reference/usage-and-quota/check-usage-and-limits"}]},{"group":"Organization Usage Analytics","pages":[{"openapi":"get /v2/admin/analytics","title":"Get usage analytics","href":"/api-reference/admin-api/get-usage-analytics"},{"openapi":"get /v2/admin/analytics/custom-tags","title":"Get custom tag usage analytics","href":"/api-reference/admin-api/get-custom-tag-usage-analytics"}]}]}]}]},"basePath":"","title":"Create a glossary - DeepL Documentation","buildId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","deploymentId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","dynamics":["10e4515597","c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["BannerMarkdown-DicSZcaX.js","dist-CIQkMg3R.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","clsx-ClVdStUn.js","html-void-elements-mCSPHezU.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","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","ApiExamples-CfHcE8m4.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C1zZV314.js","shallow-CmQhqCJn.js","getApiPlaygroundDisplay-YRo9s1O7.js","CodeSnippet-RN1MTdfk.js","CodeSnippets-DKLPHxJA.js","Page-BAvA99GL.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","AssistantPageLink-ImrFS4Fy.js"]}