Для AI-агентов: markdown этой страницы — /docs-content/userfields/tasks/list.md индекс документации — /llms.txt
Список полей
GET /v1/userfields/tasks
Метод Б24: task.item.userfield.getlist. Скоуп: task.
Фильтры: userTypeId, fieldName, lang. Язык подписей по умолчанию — язык ключа или ru. Ответ: {success:true,data:[...],meta:{total}}. total равен длине массива; пагинации нет. Варианты списка находятся в items, включая id, value, sort, def, xmlId. Системные поля имеют system:true.
Ошибки и доступ
Нет скоупа: 403 SCOPE_DENIED. Без тарифной фичи TASK_CUSTOM_FIELDS: 403 TASK_CUSTOM_FIELDS_UNAVAILABLE, включая чтение. Поле не найдено: 404 ENTITY_NOT_FOUND. Невалидный ввод: 400; бизнес-отказ Б24: 422. Нет прав Б24 на запись: 403. Чтения доступны READONLY-ключу; записи требуют READWRITE и прав администратора портала. Записи автоматически не повторяются. После таймаута исход неизвестен: перечитайте поле перед новой записью.