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

Отвязать домен

DELETE /v1/infra/servers/:id/domain

Отвязывает домен от сервера: приложение перестаёт отвечать по этому имени, а само имя освобождается для новой привязки. Восстановить привязку через API нельзя — привязывайте домен заново.

Кому доступен вызов — Доступ.

Параметры

Параметр В Тип Обяз. Описание
Параметрid Вpath Типstring (UUID) Обяз.да ОписаниеID сервера. Источник — поле id из списка серверов

Примеры

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

Terminal 
curl -X DELETE "https://vibecode.bitrix24.tech/v1/infra/servers/SERVER_ID/domain" \
  -H "X-Api-Key: YOUR_API_KEY"

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

Terminal 
curl -X DELETE "https://vibecode.bitrix24.tech/v1/infra/servers/SERVER_ID/domain" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"

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

javascript 
const res = await fetch(
  `https://vibecode.bitrix24.tech/v1/infra/servers/${serverId}/domain`,
  { method: 'DELETE', headers: { 'X-Api-Key': 'YOUR_API_KEY' } }
)
const body = await res.json()
if (body.success) console.log('Домен отвязан')

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

javascript 
const res = await fetch(
  `https://vibecode.bitrix24.tech/v1/infra/servers/${serverId}/domain`,
  {
    method: 'DELETE',
    headers: {
      'X-Api-Key': 'YOUR_APP_KEY',
      'Authorization': 'Bearer USER_SESSION_TOKEN',
    },
  }
)

Поля ответа

Поле Тип Описание
Полеsuccess Типboolean Описаниеtrue при успешной отвязке
Полеdata.deleted Типboolean Описаниеtrue — привязка удалена

В отличие от удаления записей CRM-сущностей, этот эндпоинт отвечает 200 с телом, а не 204 No Content.

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

JSON 
{
  "success": true,
  "data": {
    "deleted": true
  }
}

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

404 — к серверу не привязан домен:

JSON 
{
  "success": false,
  "error": {
    "code": "NO_DOMAIN",
    "message": "No domain attached"
  }
}

Ошибки

HTTP Код Описание
HTTP401 КодMISSING_API_KEY ОписаниеНе передан заголовок X-Api-Key
HTTP401 КодINVALID_API_KEY ОписаниеКлюч не опознан: такой строки на платформе нет
HTTP403 КодINFRA_SCOPE_REQUIRED ОписаниеУ ключа нет скоупа vibe:infra. Проверяется раньше, чем поиск сервера
HTTP403 КодINFRA_FORBIDDEN_FOR_COWORK_KEY ОписаниеВызов сделан ключом Cowork/Code — такой ключ работает только с данными, изменяющие операции ему закрыты. Что делать — Проектный ключ для деплоя
HTTP403 КодWRITE_BLOCKED_READONLY_KEY ОписаниеКлюч в режиме «только чтение» — изменяющие операции ему закрыты
HTTP404 КодSERVER_NOT_FOUND ОписаниеСервер не найден, удалён либо им управляет другой ключ
HTTP404 КодNO_DOMAIN ОписаниеК серверу не привязан домен, в том числе при повторной отвязке
HTTP429 КодRATE_LIMITED ОписаниеПревышен лимит 5 запросов в минуту на этот эндпоинт. Лимит считается на владельца ключа, а не на отдельный ключ. Точное значение — в заголовке x-ratelimit-limit (потолок делится на реплики)
HTTP503 КодCUSTOM_DOMAIN_REGISTRY_UNAVAILABLE ОписаниеРеестр доменов не ответил, домен не отвязан. Домен в статусе ACTIVE при этом переходит в SUSPENDED, и приложение может перестать отвечать по нему. Повторите вызов позже
HTTP503 Кодuser_self_deletion_pending ОписаниеВладелец ключа запросил удаление своего аккаунта на портале. Доступ вернётся после отмены удаления

Полный список общих ошибок API — Ошибки.

Известные особенности

  • Записи у DNS-провайдера остаются. Отвязка их не трогает: TXT и CNAME либо A удалите сами.
  • Прежняя запись TXT для новой привязки не подойдёт. Привязка того же имени заново выдаёт новое значение TXT, поэтому запись у DNS-провайдера нужно заменить и пройти проверку ещё раз.

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