---
title: "Create User Word Memory"
method: POST
path: "/v1/external/users/me/word-memories"
tags: ["Word Memory"]
---

# Create User Word Memory

`POST /v1/external/users/me/word-memories`

## Request

- Base URL: `https://api.tiro.ooo`
- URL: `https://api.tiro.ooo/v1/external/users/me/word-memories`
- Auth: HTTP bearer

Register a new word to the user's personal word memory.

Once registered, Tiro references this word during voice transcription to improve recognition accuracy. Useful for proper nouns, technical terms, or any word that standard speech-to-text may not recognize correctly.

Duplicate entries (same `entry` value) are not allowed and will return `409 Conflict`.

## Request body

- CreateWordMemoryRequest
  - `entry` string, required: The word or term to register. Must not be blank. Max 63 characters.
  - `subEntry` string, nullable: Optional secondary form of the term (e.g. an alternate spelling). Max 63 characters.

## Response `201`

Word memory created

- WordMemory
  - `id` integer, required: Unique identifier of the word memory
  - `entry` string, required: The registered word or term
  - `subEntry` string, nullable: Optional secondary form of the term — for example an alternate spelling or written notation paired with the pronunciation in `entry`. `null` when not set.
  - `createdAt` string, date-time, required: When the word memory was created (ISO 8601)

## Other responses

- `400`: Bad request — entry is blank
- `401`: Unauthorized
- `409`: Conflict — a word memory with the same entry already exists

---

[API](https://skmtc.dev/tiro/apis/tiro-api-2.md) · [All operations](https://skmtc.dev/tiro/apis/tiro-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/tiro/apis/tiro-api-2/revisions/dc1a260c6771?raw)