---
title: "Replace or create a term list"
method: PUT
path: "/v3/spoken-terms/{spoken_terms_id}/term-lists"
tags: ["ManageSpokenTerms"]
---

# Replace or create a term list

`PUT /v3/spoken-terms/{spoken_terms_id}/term-lists`

Replace an existing term list for a language, or create a new one if it doesn't exist.

## Path parameters

- `spoken_terms_id` string, required

## Request body

- PutSpokenTermsListParameters
  - `lang` string, required — Language code (ISO 639-1) for this term list.
  - `entries` string, required — Newline-separated list of terms. Maximum 300 characters total.

## Response `200`

Successfully replaced or created term list.

- SpokenTermsList
  - `lang` string — Language code (ISO 639-1).
  - `entry_count` integer — Number of terms in this list.

## Other responses

- `400` — Bad request. Please check error message and your parameters.
- `401` — Authorization failed. Please supply a valid `DeepL-Auth-Key` via the `Authorization` header.
- `403` — Forbidden. Authorization failed or feature not available for your plan.
- `404` — The requested resource could not be found.
- `413` — The request size exceeds the limit.
- `415` — Unsupported Media Type. Must be application/json or application/x-www-form-urlencoded.
- `429` — Too many requests. Please wait and resend your request.

---

[API](https://skmtc.dev/deepl/apis/deepl-api-documentation.md) · [All operations](https://skmtc.dev/deepl/apis/deepl-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/deepl/deepl-api-documentation/revisions/3c422fcc9c54/schema)