Для AI-агентов: markdown этой страницы — /docs-content/entities/requisite-presets/preset-fields/delete.md индекс документации — /llms.txt

Удалить поле шаблона

DELETE /v1/requisite-presets/:presetId/fields/:id

Удаляет строку поля из шаблона реквизита. Поле перестаёт входить в шаблон, но из системы не удаляется — его можно добавить обратно через POST /v1/requisite-presets/:presetId/fields.

Параметры

Параметр Тип Обяз. Описание
ПараметрpresetId (path) Типnumber Обяз.да ОписаниеID шаблона реквизита
Параметрid (path) Типnumber Обяз.да ОписаниеID строки поля шаблона (из GET /v1/requisite-presets/:presetId/fields — поле id)

Примеры

curl — личный ключ

Terminal 
curl -X DELETE "https://vibecode.bitrix24.tech/v1/requisite-presets/1/fields/1" \
  -H "X-Api-Key: YOUR_API_KEY"

curl — OAuth-приложение

Terminal 
curl -X DELETE "https://vibecode.bitrix24.tech/v1/requisite-presets/1/fields/1" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"

JavaScript — личный ключ

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/requisite-presets/1/fields/1', {
  method: 'DELETE',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
  },
})

const { success, data } = await res.json()

JavaScript — OAuth-приложение

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/requisite-presets/1/fields/1', {
  method: 'DELETE',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
  },
})

const { success, data } = await res.json()

Поля ответа

Поле Тип Описание
Полеsuccess Типboolean ОписаниеВсегда true при успехе
Полеdata Типobject ОписаниеРезультат операции
Полеdata.id Типnumber ОписаниеID удалённой строки поля шаблона
Полеdata.deleted Типboolean ОписаниеВсегда true при успешном удалении

Пример ответа

JSON 
{
  "success": true,
  "data": {
    "id": 1,
    "deleted": true
  }
}

Пример ответа при ошибке

404 — строка поля не найдена:

JSON 
{
  "success": false,
  "error": {
    "code": "ENTITY_NOT_FOUND",
    "message": "The PresetField with ID '99999' is not found"
  }
}

Ошибки

HTTP Код Описание
HTTP404 КодENTITY_NOT_FOUND ОписаниеСтрока поля с таким id не найдена в данном шаблоне
HTTP400 КодINVALID_PRESET_ID ОписаниеpresetId не является положительным целым числом
HTTP400 КодINVALID_FIELD_ID Описаниеid не является положительным целым числом
HTTP403 КодSCOPE_DENIED ОписаниеAPI-ключ не имеет скоупа crm. Сообщение: This endpoint requires 'crm' scope
HTTP401 КодTOKEN_MISSING ОписаниеAPI-ключ не имеет настроенных токенов

Полный список общих ошибок API — Ошибки.

Известные особенности

Удаление обратимо. Операция удаляет поле из состава шаблона, но не уничтожает его в системе. Поле можно добавить обратно через POST /v1/requisite-presets/:presetId/fields.

Перед удалением перечитайте список. id строки поля позиционный и может измениться после изменения состава шаблона. Возьмите актуальный id из свежего списка полей, найдя строку по fieldName — иначе удаление затронет другое поле.

Смотрите также