For AI agents: markdown of this page — /docs-content-en/userfields/tasks/get.md documentation index — /llms.txt
Get field
GET /v1/userfields/tasks/:id
Bitrix24 method: task.item.userfield.get. Scope: task.
id is a positive integer. Response: {success:true,data:{id,fieldName,userTypeId,system,...}}. Labels are returned by account language; enumeration items include xmlId. A different entity or missing field returns 404 ENTITY_NOT_FOUND.
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.