Operation CategoriesДобавить поле в категорию

Добавить поле в категорию

key и type поля неизменяемы после создания. Поле с историей нельзя удалить — только архивировать, иначе прошлые значения осиротеют

curl -X POST "https://policy-engine-rest.ezig.workers.dev/api/v1/vaults/demo_vault/operation-categories/example_string/fields" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
  "key": "sale_rate",
  "label": "example_string",
  "type": "text",
  "required": true,
  "optionsJson": [
    {
      "value": "example_string",
      "label": "example_string"
    }
  ],
  "scale": 42,
  "currencyFieldKey": "ticker",
  "unit": "example_string",
  "defaultJson": "null",
  "helpText": "example_string",
  "sensitive": true,
  "orderIndex": 42
}'
{
  "id": "cmr3f41z20001psp7phmyapw3",
  "categoryId": "example_string",
  "key": "example_string",
  "label": "example_string",
  "type": "text",
  "required": true,
  "optionsJson": [
    {
      "value": "example_string",
      "label": "example_string"
    }
  ],
  "scale": 42,
  "currencyFieldKey": "example_string",
  "unit": "example_string",
  "defaultJson": "null",
  "helpText": "example_string",
  "sensitive": true,
  "orderIndex": 42,
  "archived": true,
  "createdAt": "2026-07-02T11:25:15.134Z",
  "updatedAt": "2026-07-02T11:25:15.134Z"
}
POST
/api/v1/vaults/{code}/operation-categories/{id}/fields
POST
Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token
Bearer Tokenstring
Required

better-auth session token. Мобилка/сервисы. Веб использует cookie.

better-auth session token. Мобилка/сервисы. Веб использует cookie.
API Key (cookie: better-auth.session_token)
path
codestring
Required

Уникальный код Vault'а (slug)

Content-Typestring
Required

The media type of the request body

Options: application/json
keystring
Required

Стабильный слаг поля (иммутабелен)

Min length: 1 • Max length: 64 • Pattern: ^[a-z][a-z0-9_]*$
labelstring
Required
Min length: 1 • Max length: 200
typestring
Required
Options: text, number, select, date, datetime, boolean, url, currency
optionsJsonarray

Для select

scaleinteger

Только number и currency. У currency не задан → 2 (фиат)

Min: 0 • Max: 18
currencyFieldKeystring

Только currency: key поля этой же категории с валютой суммы (select или text). Объявляет связку «сумма ↔ её тикер»: отчёт по сумме сам разложится по тикеру, а бессмысленный общий итог по разным валютам не вернётся. 400 CATEGORY_FIELD_LINK, если поля нет или оно не того типа

unitstring
Max length: 16
helpTextstring
Max length: 500
orderIndexinteger
Min: -9007199254740991 • Max: 9007199254740991
Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. better-auth session token. Мобилка/сервисы. Веб использует cookie.

path
parameterstring
Required

API Key for authentication. Provide your API key in the cookie.

Path Parameters

codestring
Required

Уникальный код Vault'а (slug)

Example:
demo_vault

Body

application/json
keystring
Required

Стабильный слаг поля (иммутабелен)

Example:
sale_rate
typestring
Required
Allowed values:textnumberselectdatedatetimebooleanurlcurrency
optionsJsonarray

Для select

scaleinteger

Только number и currency. У currency не задан → 2 (фиат)

currencyFieldKeystring

Только currency: key поля этой же категории с валютой суммы (select или text). Объявляет связку «сумма ↔ её тикер»: отчёт по сумме сам разложится по тикеру, а бессмысленный общий итог по разным валютам не вернётся. 400 CATEGORY_FIELD_LINK, если поля нет или оно не того типа

Example:
ticker

Responses