For AI agents: markdown of this page — /docs-content-en/entities/recurring-deals/delete.md documentation index — /llms.txt

Delete recurring settings

DELETE /v1/recurring-deals/:id

Bitrix24 only deletes settings when the linked template deal no longer exists. While the template exists, the response is 422 with Deleting is impossible. Connected recurring deal exists. Delete an owned template through the deals endpoint: Bitrix24 removes its recurring settings automatically. The source and generated deals are removed separately.

Response fields

A successful deletion returns 204 with an empty body.

Example

curl — personal key

Terminal 
curl -X DELETE "https://vibecode.bitrix24.com/v1/recurring-deals/11" \
  -H "X-Api-Key: YOUR_API_KEY"

curl — OAuth application

Terminal 
curl -X DELETE "https://vibecode.bitrix24.com/v1/recurring-deals/11" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"

JavaScript — personal key

javascript 
const response = await fetch('https://vibecode.bitrix24.com/v1/recurring-deals/11', {
  method: 'DELETE',
  headers: { 'X-Api-Key': 'YOUR_API_KEY' },
})
if (response.status !== 204) throw new Error(await response.text())

JavaScript — OAuth application

javascript 
const response = await fetch('https://vibecode.bitrix24.com/v1/recurring-deals/11', {
  method: 'DELETE',
  headers: { 'X-Api-Key': 'YOUR_APP_KEY', 'Authorization': 'Bearer USER_SESSION_TOKEN' },
})
if (response.status !== 204) throw new Error(await response.text())

Errors

HTTP Code Condition
401 MISSING_API_KEY API key missing
403 SCOPE_DENIED crm scope missing
400 INVALID_PARAMS Invalid ID, enum or value shape
403 BITRIX_ACCESS_DENIED Bitrix24 refused access
422 BITRIX_ERROR Original Bitrix24 business refusal or plan limitation
403 WRITE_BLOCKED_READONLY_KEY Write using a read-only key
404 ENTITY_NOT_FOUND Recurring deal is not found.

System errors. Batch sub-call errors are returned within the batch result.

MCP: generic entity tools with entity: "recurring-deals"; expose uses call_api with POST and this path.

See also