Для AI-агентов: markdown этой страницы — /docs-content/userfields/tasks/create.md индекс документации — /llms.txt
Создать поле
POST /v1/userfields/tasks
Метод Б24: task.item.userfield.add. Скоуп: task.
Поле общее на весь портал: появится в каждой задаче у всех сотрудников.
Обязательны fieldName и userTypeId. Необязательны label — строка или объект по языкам, multiple, mandatory — boolean, sort — целое число, settings — объект, items — массив вариантов enumeration. Б24 приводит имя к UF_<UPPER>. label раскладывается в три подписи, без записи в текст ошибки или подсказку. boolean с multiple:true запрещён. Обязательность REST задач не навязывает: задача без значения поля создаётся. Ответ 201 {success:true,data:{id,fieldName,...}} содержит перечитанное поле.
Пример тела: {"fieldName":"UF_VIBEPROBE_CLIENT","userTypeId":"enumeration","label":"Клиент","items":[{"value":"Первый","xmlId":"first"},{"value":"Второй","xmlId":"second"}]}.
Ошибки и доступ
Нет скоупа: 403 SCOPE_DENIED. Без тарифной фичи TASK_CUSTOM_FIELDS: 403 TASK_CUSTOM_FIELDS_UNAVAILABLE, включая чтение. Поле не найдено: 404 ENTITY_NOT_FOUND. Невалидный ввод: 400; бизнес-отказ Б24: 422. Нет прав Б24 на запись: 403. Чтения доступны READONLY-ключу; записи требуют READWRITE и прав администратора портала. Записи автоматически не повторяются. После таймаута исход неизвестен: перечитайте поле перед новой записью.
Сортировка варианта items.sort должна быть положительной: Б24 игнорирует ноль. Для снятия def:true у одиночного списка выберите другой вариант с def:true в том же PATCH; иначе 400 INVALID_PARAMS. После подтверждённой записи ошибка перечитывания даёт 502 TASK_USERFIELD_READBACK_FAILED с error.fieldId и error.writeConfirmed:true: повторите GET, не запись.