Replace or create a term list
curl --request PUT \
--url https://api.deepl.com/v3/spoken-terms/{spoken_terms_id}/term-lists \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"lang": "en",
"entries": "DeepL\nAPI\nwebhook\nintegration"
}
'{
"lang": "en",
"entry_count": 3
}{
"message": "Bad request"
}{
"message": "<string>",
"code": "invalid_content_type"
}{
"message": "Forbidden. Authorization failed or feature not available for your plan."
}{
"message": "<string>",
"code": "invalid_content_type"
}{
"message": "<string>",
"code": "invalid_content_type"
}{
"message": "Unsupported Content-Type"
}{
"message": "<string>",
"code": "invalid_content_type"
}Spoken Terms
Replace or create a term list
Replace an existing term list for a language, or create a new one if it doesn’t exist
PUT
/
v3
/
spoken-terms
/
{spoken_terms_id}
/
term-lists
Replace or create a term list
curl --request PUT \
--url https://api.deepl.com/v3/spoken-terms/{spoken_terms_id}/term-lists \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"lang": "en",
"entries": "DeepL\nAPI\nwebhook\nintegration"
}
'{
"lang": "en",
"entry_count": 3
}{
"message": "Bad request"
}{
"message": "<string>",
"code": "invalid_content_type"
}{
"message": "Forbidden. Authorization failed or feature not available for your plan."
}{
"message": "<string>",
"code": "invalid_content_type"
}{
"message": "<string>",
"code": "invalid_content_type"
}{
"message": "Unsupported Content-Type"
}{
"message": "<string>",
"code": "invalid_content_type"
}Authorizations
Authentication with Authorization header and DeepL-Auth-Key authentication scheme. Example: DeepL-Auth-Key <api-key>
Path Parameters
A unique ID assigned to the Spoken Terms collection.
Body
application/jsonapplication/x-www-form-urlencoded
Language code (ISO 639-1) for this term list.
Example:
"en"
Newline-separated list of terms, one term per line. Maximum 300 characters total.
Terms are case-sensitive. Each term must be non-empty, must not contain C0 or C1 control characters (such as tabs or newlines within a term), and must not have leading or trailing whitespace. Duplicate terms within a list are not allowed (comparison is case-sensitive).
Maximum string length:
300Example:
"DeepL\nAPI\nwebhook\nintegration"