For AI agents: markdown of this page — /docs-content-en/userfields/tasks/delete.md documentation index — /llms.txt
Delete field
DELETE /v1/userfields/tasks/:id
Bitrix24 method: task.item.userfield.delete. Scope: task.
Field values disappear from every task in the account with no recovery.
Deletes the field schema, enumeration variants and stored values. Recreating the same field name does not restore values. The field is read before deletion. System fields are protected: 403 SYSTEM_FIELD_PROTECTED. Response: 204 with no body. A repeated delete 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.