Для AI-агентов: markdown этой страницы — /docs-content/entities/crm-tracking/expenses-delete.md индекс документации — /llms.txt
Удалить расходы источника сквозной аналитики
DELETE /v1/crm-tracking/expenses/:id
Удаляет пакет расходов, добавленный вручную. Пакеты рекламных интеграций удалять нельзя. Восстановить удалённый пакет через API нельзя — при необходимости создайте новый.
Метод выходит в обновлении
crm 26.2100.0и доступен не на всех порталах Битрикс24. Пока возможность не включена для портала, API возвращает422 METHOD_NOT_YET_AVAILABLE.
Требуется скоуп crm и ключ с правом записи READWRITE.
Параметры
| Параметр | Тип | Обяз. | По умолч. | Описание |
|---|---|---|---|---|
Параметрid (path) |
Типinteger | Обяз.да | По умолч.— | ОписаниеПоложительный ID пакета расходов. Список расходов |
Параметры строки запроса и поля тела запроса не принимаются.
Примеры
curl — личный ключ
curl -i -X DELETE "https://vibecode.bitrix24.tech/v1/crm-tracking/expenses/7" \
-H "X-Api-Key: YOUR_API_KEY"
curl — OAuth-приложение
curl -i -X DELETE "https://vibecode.bitrix24.tech/v1/crm-tracking/expenses/7" \
-H "X-Api-Key: YOUR_APP_KEY" \
-H "Authorization: Bearer USER_SESSION_TOKEN"
JavaScript — личный ключ
const res = await fetch('https://vibecode.bitrix24.tech/v1/crm-tracking/expenses/7', {
method: 'DELETE',
headers: {
'X-Api-Key': 'YOUR_API_KEY'
}
})
if (res.status === 204) {
console.log('Удалено')
}
JavaScript — OAuth-приложение
const res = await fetch('https://vibecode.bitrix24.tech/v1/crm-tracking/expenses/7', {
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/1.1 204 No Content
Пример ответа при ошибке
400 — некорректный ID.
{"success":false,"error":{"code":"INVALID_PARAMS","message":"id must be a positive safe integer"}}
Ошибки
| HTTP | Код | Описание |
|---|---|---|
| HTTP400 | КодINVALID_PARAMS |
ОписаниеНекорректный ID или переданы поля тела запроса |
| HTTP400 | КодUNKNOWN_FILTER_FIELD |
ОписаниеПередан параметр строки запроса |
| HTTP403 | КодSCOPE_DENIED |
ОписаниеНет скоупа crm |
| HTTP403 | КодWRITE_BLOCKED_READONLY_KEY |
ОписаниеКлюч разрешает только чтение |
| HTTP404 | КодENTITY_NOT_FOUND |
ОписаниеПакет расходов не найден |
| HTTP422 | КодMETHOD_NOT_YET_AVAILABLE |
ОписаниеВозможность не включена для портала или метод недоступен в его версии |
| HTTP502 | КодBITRIX_UNAVAILABLE |
ОписаниеПолучен некорректный ответ Битрикс24 |
Другие отказы Битрикс24 передаются с его кодом и сообщением. Секреты в сообщениях удаляются. Общие ошибки — Ошибки.