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

Очистить области шаблона сайта

DELETE /v1/sites/:id/template-areas

Снимает привязки со всех областей раскладки сайта одним вызовом. Страницы, которые стояли в областях, остаются на сайте, области страниц не меняются.

Параметры

Параметр	Тип	Обяз.	Описание
`id` (path)	number	да	ID сайта. Список: `GET /v1/sites`
`scope` (query)	string	нет	Внутренняя область лендингов: `KNOWLEDGE` / `GROUP` / `MAINPAGE`. Указывайте, если сайт принадлежит соответствующей области. Иначе возвращается `404 ENTITY_NOT_FOUND`. Для обычного сайта не передаётся

Тело запроса не нужно: тело с любым полем отвечает 400 INVALID_PARAMS.

Примеры

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

Terminal

curl -X DELETE "https://vibecode.bitrix24.tech/v1/sites/225/template-areas" \
  -H "X-Api-Key: YOUR_API_KEY"

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

Terminal

curl -X DELETE "https://vibecode.bitrix24.tech/v1/sites/225/template-areas" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"

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

javascript

const res = await fetch('https://vibecode.bitrix24.tech/v1/sites/225/template-areas', {
  method: 'DELETE',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
  },
})

const { success, data } = await res.json()
console.log('Области очищены:', success && Object.keys(data.areas).length === 0)

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

javascript

const res = await fetch('https://vibecode.bitrix24.tech/v1/sites/225/template-areas', {
  method: 'DELETE',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
  },
})

const { success, data } = await res.json()

Поля ответа

Метод отвечает 200 с телом, а не 204: в ответе — привязки сайта после очистки.

Поле	Тип	Описание
`success`	boolean	Всегда `true` при успехе
`data.areas`	object	Привязки областей сайта после очистки. При успехе всегда пустой объект `{}`. Формат непустого объекта — Получить области шаблона сайта

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

JSON

{
  "success": true,
  "data": {
    "areas": {}
  }
}

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

409 — в это же время идёт другая запись областей этого сайта: