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

Удалить значение списочного свойства

DELETE /v1/catalog-product-property-enums/:id

Удаляет вариант списочного свойства каталога по идентификатору. Восстановить удалённый вариант через API нельзя.

Перед удалением проверьте, что товары больше не используют это значение.

Параметры

Параметр Тип Обяз. Описание
id (path) number да Идентификатор значения из списка значений

Примеры

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

Terminal 
curl -X DELETE "https://vibecode.bitrix24.tech/v1/catalog-product-property-enums/1769" \
  -H "X-Api-Key: YOUR_API_KEY"

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

Terminal 
curl -X DELETE "https://vibecode.bitrix24.tech/v1/catalog-product-property-enums/1769" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"

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

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/catalog-product-property-enums/1769', {
  method: 'DELETE',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
  },
})

if (res.status === 204) {
  console.log('Значение удалено')
}

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

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/catalog-product-property-enums/1769', {
  method: 'DELETE',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
  },
})

if (res.status === 204) {
  console.log('Значение удалено')
}

Ответ

При успешном удалении возвращается HTTP-статус 204 No Content с пустым телом. Успех проверяется по статусу ответа.

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

http 
HTTP/1.1 204 No Content

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

404 — значение уже удалено:

JSON 
{
  "success": false,
  "error": {
    "code": "ENTITY_NOT_FOUND",
    "message": "productPropertyEnum does not exist."
  }
}

Ошибки

HTTP Код Описание
400 INVALID_PARAMS Некорректный id в пути
404 ENTITY_NOT_FOUND Значения с указанным идентификатором нет
422 BITRIX_ERROR Битрикс24 отклонил удаление. Причина — в error.message
403 SCOPE_DENIED API-ключ не имеет скоупа catalog
403 WRITE_BLOCKED_READONLY_KEY API-ключ разрешает только чтение
401 MISSING_API_KEY Не передан заголовок X-Api-Key

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

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