---
title: "ユーザー辞書に登録されている単語を更新する"
method: PUT
path: "/user_dict_word/{word_uuid}"
tags: ["ユーザー辞書"]
---

# ユーザー辞書に登録されている単語を更新する

`PUT /user_dict_word/{word_uuid}`

## Request

- The document declares no server URL.
- Auth: none declared

ユーザー辞書に登録されている単語を更新します。<br>
複合語を辞書に追加するには、`?surface=新田&surface=真剣佑&pronunciation=あらた&pronunciation=まっけんゆう&accent_type=1&accent_type=3` のように、`surface`, `pronunciation`, `accent_type` を同じ長さのリストで指定します。

## Path parameters

- `word_uuid` string, required: 更新する単語の UUID

## Query parameters

- `surface` string[], required: 単語の表層形
- `pronunciation` string[], required: 単語の発音（カタカナ）
- `accent_type` integer[], required: 東京式アクセントにおけるアクセント型<br>音高が下がる直前のモーラのインデックスを 1-indexed で指定します。0 は平板型を意味します。<br>例として、`surface: ["新田", "真剣佑"], pronunciation: ["あらた", "まっけんゆう"]` のとき、`accent_type: [1, 3]` (新田 → 頭高型, 真剣佑 → 中高型) のように指定します。
- `word_type` 'PROPER_NOUN' | 'LOCATION_NAME' | 'ORGANIZATION_NAME' | 'PERSON_NAME' | 'PERSON_FAMILY_NAME' | 'PERSON_GIVEN_NAME' | 'COMMON_NOUN' | 'VERB' | 'ADJECTIVE' | 'SUFFIX': 品詞を表す列挙型。
- `priority` integer: 単語の優先度 (1~9 の範囲を推奨)<br>数値が大きいほど、辞書適用時に優先して利用されます。<br>未指定時は `5` が設定されます。

## Response `204`

Successful Response

## Other responses

- `422`: Validation Error

## Changes

- **2026-03-31** `bd7182f25e54`: 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-04-01** `d31381d669ec`: 2 breaking, 1 info
  - for the `query` request parameter `priority`, default value `5` was added
  - for the `query` request parameter `word_type`, default value `PROPER_NOUN` was added
  - api operation id `rewrite_user_dict_word` removed and replaced with `update_user_dict_word`
- **2025-03-19** `fc00e77ecad2`: 3 info
  - for the `query` request parameter `accent_type`, the type was generalized from `integer` to `array`
  - for the `query` request parameter `pronunciation`, the type was generalized from `string` to `array`
  - for the `query` request parameter `surface`, the type was generalized from `string` to `array`
- **2025-03-11** `c5651c641b9a`: 5 info
  - added the new enum value `LOCATION_NAME` to the `query` request parameter `word_type`
  - added the new enum value `ORGANIZATION_NAME` to the `query` request parameter `word_type`
  - added the new enum value `PERSON_FAMILY_NAME` to the `query` request parameter `word_type`
  - added the new enum value `PERSON_GIVEN_NAME` to the `query` request parameter `word_type`
  - …1 more
- …earlier changes not shown

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

---

[API](https://skmtc.dev/aivis-project/apis/aivisspeech-engine.md) - [All operations](https://skmtc.dev/aivis-project/apis/aivisspeech-engine/llms.txt) - [OpenAPI document](https://skmtc.dev/aivis-project/apis/aivisspeech-engine/revisions/1d935a3e31b8?raw)