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

Delete: Booking resource types

DELETE /v1/booking-resource-types/:id

Requires booking scope. Writes require READWRITE. Body fields are flat, without an outer fields object. Setting work hours does not create a booking.

Bitrix24 refuses deletion of a resource with future bookings; 422, no cascading booking deletion. A type with active resources is also refused. Some cloud versions return TYPE_ID even after resources are deleted. Success: 204, no response body.

Parameters

Field	Description
id	Identifier from list.

Response fields

Success 204 has no body.

Examples

cURL — personal key

Terminal

curl -X DELETE "https://vibecode.bitrix24.com/v1/booking-resource-types/7" -H "X-Api-Key: $VIBE_API_KEY"

cURL — OAuth

Terminal

curl -X DELETE "https://vibecode.bitrix24.com/v1/booking-resource-types/7" -H "X-Api-Key: $VIBE_API_KEY" -H "Authorization: Bearer $SESSION_TOKEN"

JavaScript — personal key

javascript

const response = await fetch('https://vibecode.bitrix24.com/v1/booking-resource-types/7', {
  method: 'DELETE',
  headers: { 'X-Api-Key': apiKey },
});
if (response.status !== 204) console.log(await response.json());

JavaScript — OAuth

javascript

const response = await fetch('https://vibecode.bitrix24.com/v1/booking-resource-types/7', {
  method: 'DELETE',
  headers: { 'X-Api-Key': apiKey, Authorization: `Bearer ${sessionToken}` },
});
if (response.status !== 204) console.log(await response.json());

Errors

HTTP	Code	Condition
400	INVALID_PARAMS	Malformed path/body/query
400	MISSING_REQUIRED_FIELDS	Missing name for resource create or code for type create
400	READONLY_FIELD	id in write body
401	TOKEN_MISSING	No Bitrix24 credentials
403	SCOPE_DENIED	Missing booking scope
403	WRITE_BLOCKED_READONLY_KEY	Write with read-only key
404	ENTITY_NOT_FOUND	Missing record
422	BITRIX_ERROR	Bitrix24 business refusal
429	RATE_LIMITED	Rate limit
502	BITRIX_RESPONSE_INVALID	Invalid upstream payload
503	BITRIX_TIMEOUT	Upstream timeout

Errors.

404 — record not found:

JSON

{"success":false,"error":{"code":"ENTITY_NOT_FOUND","message":"Booking record not found"}}