---
title: "Bulk Update User Word Memories"
method: PATCH
path: "/v1/external/users/me/word-memories/bulk"
tags: ["Word Memory"]
---

# Bulk Update User Word Memories

`PATCH /v1/external/users/me/word-memories/bulk`

## Request

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

Update multiple word memories in one request (up to 1000). Processed atomically — if any `id` is not found (`404`) or an update would create a duplicate (`409`), the entire batch is rolled back.

## Request body

- BulkUpdateWordMemoryRequest
  - `items` BulkUpdateWordMemoryItem[], required: Word memories to update. Processed atomically — if any `id` is not found (404) or a conflict occurs (409), the entire batch is rolled back.
    - `id` integer, required: ID of the word memory to update
    - `entry` string: Updated word or term. Must not be blank if provided. Max 63 characters.
    - `subEntry` string, nullable: Updated secondary form of the term. Max 63 characters.

## Response `200`

Updated word memories

- WordMemoryListResponse
  - `content` WordMemory[], required
    - `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)
  - `totalSize` integer, nullable: Always `null` for bulk responses

## Other responses

- `400`: Bad request — empty list or more than 1000 items
- `401`: Unauthorized
- `404`: Not found — one or more IDs do not exist (batch rolled back)
- `409`: Conflict — an update would create a duplicate (batch rolled back)

---

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