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

Пакетные операции

POST /v1/recurring-deals/batch

Используйте action create/update/delete с items или ids. Ключ только для чтения отказывает в записи. Глобальный /v1/batch тоже поддерживает семью.

Поля ответа

Поле Тип Значение
success boolean Признак успеха
data object Результаты по общему контракту

Пример

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

Terminal 
curl -X POST "https://vibecode.bitrix24.tech/v1/recurring-deals/batch" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"action":"update","items":[{"id":11,"active":false}]}'

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

Terminal 
curl -X POST "https://vibecode.bitrix24.tech/v1/recurring-deals/batch" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action":"update","items":[{"id":11,"active":false}]}'

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

javascript 
const response = await fetch('https://vibecode.bitrix24.tech/v1/recurring-deals/batch', {
  method: 'POST',
  headers: { 'X-Api-Key': 'YOUR_API_KEY', 'Content-Type': 'application/json' },
  body: JSON.stringify({"action":"update","items":[{"id":11,"active":false}]}),
})
const result = await response.json()
if (!result.success) throw new Error(result.error.message)
console.log(result.data)

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

javascript 
const response = await fetch('https://vibecode.bitrix24.tech/v1/recurring-deals/batch', {
  method: 'POST',
  headers: { 'X-Api-Key': 'YOUR_APP_KEY', 'Authorization': 'Bearer USER_SESSION_TOKEN', 'Content-Type': 'application/json' },
  body: JSON.stringify({"action":"update","items":[{"id":11,"active":false}]}),
})
const result = await response.json()
if (!result.success) throw new Error(result.error.message)
console.log(result.data)

Ошибки

HTTP Код Условие
401 MISSING_API_KEY Отсутствует API-ключ
403 SCOPE_DENIED Отсутствует скоуп crm
400 INVALID_PARAMS Неверный ID, enum или форма значения
403 BITRIX_ACCESS_DENIED Битрикс24 отказал в доступе
422 BITRIX_ERROR Исходный бизнес-отказ Битрикс24 или ограничение тарифа
403 WRITE_BLOCKED_READONLY_KEY Запись ключом только для чтения

Системные ошибки. Ошибки подзапросов batch возвращаются внутри результата пакета.

MCP: общие инструменты сущностей с entity: "recurring-deals"; expose — call_api с POST по этому пути.

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