---
title: "Добавить запись справочника"
method: POST
path: "/api/v1/core/dictionaries/{id}/items"
tags: ["Core directories"]
---

# Добавить запись справочника

`POST /api/v1/core/dictionaries/{id}/items`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/core/dictionaries/{id}/items`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Api-Key`
  - OAuth 2 (authorization code, authorization URL `https://erp.akeda.ru/oauth2/authorize`, token URL `https://erp.akeda.ru/oauth2/token`, scopes: `akeda:delegate`)
  - HTTP bearer

Код можно не передавать при ручном создании; сервер построит его из названия.

## Request body

- CoreDictionaryItemCreate
  - `code` string
  - `label` string, required
  - `parent_id` string, uuid
  - `attrs` object
  - `sort_order` integer
  - `is_active` boolean

## Response `201`

Созданная запись

- CoreDictionaryItem
  - `id` string, uuid, required
  - `dictionary_id` string, uuid, required
  - `code` string, required
  - `label` string, required
  - `label_key` string: Ключ перевода подписи записи из посева (ERP-2627), вида common:seeded.dictionaries.<справочник>.<код>; есть, пока запись носит имя посева. Переименованная клиентом запись ключа не имеет
  - `parent_id` string, uuid, required
  - `attrs` object, required
  - `sort_order` integer, required
  - `is_active` boolean, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `400`: Некорректный запрос или нарушение бизнес-правила
- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `404`: Запись не найдена или не видима текущему пользователю
- `409`: Конфликт версии, идемпотентности или бизнес-состояния

## Changes

- **2026-10-20** `a99574d597cc`: 1 info
  - added the optional property `label_key` to the response with the `201` status

[Operation history](https://skmtc.dev/akeda/apis/akeda-erp-client-api/changes/api/v1/core/dictionaries/:id/items/post.md)

---

[API](https://skmtc.dev/akeda/apis/akeda-erp-client-api.md) · [All operations](https://skmtc.dev/akeda/apis/akeda-erp-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/akeda/apis/akeda-erp-client-api/revisions/a99574d597cc?raw)