---
title: "Rewrite User Dict Word"
method: PUT
path: "/user_dict_word/{word_uuid}"
tags: ["ユーザー辞書"]
---

# Rewrite User Dict Word

`PUT /user_dict_word/{word_uuid}`

## Request

- The document declares no server URL.
- Auth: none declared
- TypeScript: <https://skmtc.dev/voicevox/apis/voicevox-engine-oss/docs/user_dict_word/:word_uuid/put.ts> (a function with typed inputs; its response is checked against the schema)

ユーザー辞書に登録されている言葉を更新します。

## Path parameters

- `word_uuid` string, required: 更新する言葉のUUID

## Query parameters

- `surface` string, required: 言葉の表層形
- `pronunciation` string, required: 言葉の発音（カタカナ）
- `accent_type` integer, required: アクセント型（音が下がる場所を指す）
- `word_type` 'PROPER_NOUN' | 'COMMON_NOUN' | 'VERB' | 'ADJECTIVE' | 'SUFFIX': 品詞
- `priority` integer: 単語の優先度（0から10までの整数）。数字が大きいほど優先度が高くなる。1から9までの値を指定することを推奨。

## Response `204`

Successful Response

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-27** `bea1c63c3d6f`: 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2025-03-02** `d8b6a60f88af`: 1 info
  - api operation id `rewrite_user_dict_word_user_dict_word__word_uuid__put` removed and replaced with `rewrite_user_dict_word`
- **2025-01-03** `b7afc41080b3`: 1 breaking, 6 info
  - the `query` request parameter `word_type` was restricted to a list of enum values
  - added the new enum value `ADJECTIVE` to the `query` request parameter `word_type`
  - added the new enum value `COMMON_NOUN` to the `query` request parameter `word_type`
  - added the new enum value `PROPER_NOUN` to the `query` request parameter `word_type`
  - …3 more
- **2024-04-26** `907e5011a1aa`: 5 breaking, 1 info
  - removed the enum value `ADJECTIVE` from the `query` request parameter `word_type`
  - removed the enum value `COMMON_NOUN` from the `query` request parameter `word_type`
  - removed the enum value `PROPER_NOUN` from the `query` request parameter `word_type`
  - removed the enum value `SUFFIX` from the `query` request parameter `word_type`
  - …2 more
- **2024-01-17** `98b1b5ed5d83`: 1 breaking
  - response property `detail/items/loc/items/` list-of-types was widened by adding types `integer` to media type `application/json` of response `422`

[Operation history](https://skmtc.dev/voicevox/apis/voicevox-engine-oss/changes/user_dict_word/:word_uuid/put.md)

---

[API](https://skmtc.dev/voicevox/apis/voicevox-engine-oss.md) - [All operations](https://skmtc.dev/voicevox/apis/voicevox-engine-oss/llms.txt) - [OpenAPI document](https://skmtc.dev/voicevox/apis/voicevox-engine-oss/revisions/9adfe4501140?raw)