For AI agents: markdown of this page — /docs-content-en/userfields/tasks/types.md documentation index — /llms.txt

Field types

GET /v1/userfields/tasks/types

Bitrix24 method: task.item.userfield.gettypes. Scope: task.

Response: {success:true,data:[{userTypeId,title}]}. This is the shared Bitrix24 type catalog for all entities. Official task documentation lists string, double, datetime, boolean; Bitrix24 accepts other registered types too. System and application-defined types may be absent from this catalog.

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.

All task field operations