Для AI-агентов: markdown этой страницы — /docs-content/userfields/tasks/delete.md индекс документации — /llms.txt
Удалить поле
DELETE /v1/userfields/tasks/:id
Метод Б24: task.item.userfield.delete. Скоуп: task.
Значения поля исчезнут во всех задачах портала без возможности восстановления.
Удаляется схема поля, его варианты списка и значения. Пересоздание поля с тем же именем значения не вернёт. Поле перечитывается до удаления. Системные поля защищены: 403 SYSTEM_FIELD_PROTECTED. Ответ — 204 без тела. Повторное удаление — 404 ENTITY_NOT_FOUND.
Ошибки и доступ
Нет скоупа: 403 SCOPE_DENIED. Без тарифной фичи TASK_CUSTOM_FIELDS: 403 TASK_CUSTOM_FIELDS_UNAVAILABLE, включая чтение. Поле не найдено: 404 ENTITY_NOT_FOUND. Невалидный ввод: 400; бизнес-отказ Б24: 422. Нет прав Б24 на запись: 403. Чтения доступны READONLY-ключу; записи требуют READWRITE и прав администратора портала. Записи автоматически не повторяются. После таймаута исход неизвестен: перечитайте поле перед новой записью.