---
title: "Bulk Create Organization Word Memories"
method: POST
path: "/v1/external/organizations/me/word-memories/bulk"
tags: ["Word Memory"]
---

# Bulk Create Organization Word Memories

`POST /v1/external/organizations/me/word-memories/bulk`

## Request

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

Create multiple organization word memories in one request (up to 1000). Duplicate `(entry, subEntry)` pairs are silently skipped, so the response contains only the newly created entries. Safe to re-run (idempotent). Requires an **organization** API key.

## Request body

- BulkCreateWordMemoryRequest
  - `entries` CreateWordMemoryRequest[], required: Word memories to create. Duplicate `(entry, subEntry)` pairs — against both existing entries and other items in the same request — are silently skipped (idempotent, safe for CSV re-upload).
    - `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`

Created word memories (duplicates skipped)

- 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, more than 1000 items, or a blank entry
- `401`: Unauthorized — an organization API key is required

---

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