---
title: "Create Dictionary"
method: POST
path: "/v1/dictionaries"
---

# Create Dictionary

`POST /v1/dictionaries`

Create a new dictionary scoped to the caller's project.

## Query parameters

- `project_id` integer, nullable

## Request body

- CreateDictionaryRequest — Create a new dictionary scoped to a project.
  - `name` string, required
  - `description` string, nullable
  - `language` string, nullable — BCP-47 language tag (e.g. 'en', 'de-DE'). Omit for all languages.

## Response `201`

Successful Response

- DictionaryResponse — A single dictionary record.
  - `id` integer, required
  - `project_id` integer, required
  - `name` string, required
  - `description` string, nullable
  - `language` string, nullable
  - `is_active` boolean, required
  - `created_at` string, required
  - `updated_at` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/kugelaudio/apis/kugelaudio-tts-api.md) · [All operations](https://skmtc.net/kugelaudio/apis/kugelaudio-tts-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kugelaudio/kugelaudio-tts-api/revisions/9ecca94b0377/schema)