---
title: "Edit Spoken Terms collection details"
method: PATCH
path: "/v3/spoken-terms/{spoken_terms_id}"
tags: ["ManageSpokenTerms"]
---

# Edit Spoken Terms collection details

`PATCH /v3/spoken-terms/{spoken_terms_id}`

Update the name of a Spoken Terms collection or merge new entries into an existing term list.

## Path parameters

- `spoken_terms_id` string, required

## Request body

- PatchSpokenTermsParameters
  - `name` string — New name for the Spoken Terms collection.
  - `term_lists` SpokenTermsListInput[] — Term lists to merge with existing lists.
    - `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 updated Spoken Terms collection.

- SpokenTerms
  - `spoken_terms_id` string — A unique ID assigned to the Spoken Terms collection.
  - `name` string — Name of the Spoken Terms collection.
  - `term_lists` SpokenTermsList[] — List of term lists contained in this collection.
    - `lang` string — Language code (ISO 639-1).
    - `entry_count` integer — Number of terms in this list.
  - `creation_time` string, date-time — The creation time of the Spoken Terms collection in ISO 8601-1:2019 format (e.g.: `2025-08-03T14:16:18.329Z`).

## 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)