Для 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 Код Описание
404 ENTITY_NOT_FOUND Строка поля с таким id не найдена в данном шаблоне
400 INVALID_PRESET_ID presetId не является положительным целым числом
400 INVALID_FIELD_ID id не является положительным целым числом
403 SCOPE_DENIED API-ключ не имеет скоупа crm. Сообщение: This endpoint requires 'crm' scope
401 TOKEN_MISSING API-ключ не имеет настроенных токенов

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

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

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

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

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