For AI agents: markdown of this page — /docs-content-en/userfields/tasks/list.md documentation index — /llms.txt
List fields
GET /v1/userfields/tasks
Bitrix24 method: task.item.userfield.getlist. Scope: task.
Filters: userTypeId, fieldName, lang. Label language defaults to the key language or ru. Response: {success:true,data:[...],meta:{total}}. total is the array length; there is no pagination. Enumeration variants are in items, including id, value, sort, def, xmlId. System fields have system:true.
Errors and access
Missing scope: 403 SCOPE_DENIED. Portal plan without TASK_CUSTOM_FIELDS: 403 TASK_CUSTOM_FIELDS_UNAVAILABLE, including reads. Nonexistent fields: 404 ENTITY_NOT_FOUND. Invalid input: 400; Bitrix24 business refusals: 422. Bitrix24 write permission refusals: 403. Reads accept READONLY keys; writes require READWRITE and portal administrator rights. Writes are never retried automatically. After a timeout, the outcome is unknown: reread the field before another write.