# Список полей

`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 и прав администратора портала. Записи автоматически не повторяются. После таймаута исход неизвестен: перечитайте поле перед новой записью.

[Все операции полей задач](/docs/userfields/tasks)