---
title: "読みの辞書に登録する（語→読み。同じ語は上書き）"
method: PUT
path: "/api/v1/pronunciations"
tags: ["pronunciations"]
---

# 読みの辞書に登録する（語→読み。同じ語は上書き）

`PUT /api/v1/pronunciations`

## Request

- Base URL: `https://app.yukkurigen.com`
- URL: `https://app.yukkurigen.com/api/v1/pronunciations`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

## Request body

- object
  - `word` string, required: 語（空白・改行・《》｜不可。ひらがなだけの語は不可）
  - `reading` string, required: 読み（ひらがな・カタカナ・ー だけ）
  - `note` string

## Response `200`

登録した語

- object
  - `entry` object, required
    - `word` string, required
    - `reading` string, required
    - `note` string
    - `updatedAt` string, date-time
  - `replaced` boolean, required: 同じ語を上書きした
  - `count` integer, required
  - `limit` integer, required
  - `nextStep` string

## Other responses

- `400`: 語・読みが正しくない（code: validation_error）
- `401`: 未認証（code: unauthenticated）
- `403`: 権限不足（projects:write / code: insufficient_scope）
- `409`: 辞書が500語に達している（code: dictionary_full）
- `429`: 回数の上限（code: rate_limited）

## Changes

- **2026-10-20** `ba5f36b016da`: 25 warning, 15 info
  - added the new `already_subscribed` enum value to the `code` response property for the response status `400`
  - added the new `already_subscribed` enum value to the `code` response property for the response status `401`
  - added the new `already_subscribed` enum value to the `code` response property for the response status `403`
  - added the new `already_subscribed` enum value to the `code` response property for the response status `409`
  - …36 more

[Operation history](https://skmtc.dev/yukkurigen/apis/yukkurigen-ai-operated-api/changes/api/v1/pronunciations/put.md)

---

[API](https://skmtc.dev/yukkurigen/apis/yukkurigen-ai-operated-api.md) · [All operations](https://skmtc.dev/yukkurigen/apis/yukkurigen-ai-operated-api/llms.txt) · [OpenAPI document](https://skmtc.dev/yukkurigen/apis/yukkurigen-ai-operated-api/revisions/ba5f36b016da?raw)