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

Удалить быстрый ответ

DELETE /v1/openline-configs/:lineId/quick-replies/:id

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

Параметры

Параметр Тип Обяз. Описание
ПараметрlineId (path) Типinteger Обяз.да ОписаниеID открытой линии. Список: GET /v1/openline-configs
Параметрid (path) Типinteger Обяз.да ОписаниеID быстрого ответа в этой линии. Список: GET /v1/openline-configs/:lineId/quick-replies, поле data.replies[].id

Тело запроса не передаётся.

Примеры

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

Terminal 
curl -X DELETE "https://vibecode.bitrix24.tech/v1/openline-configs/1/quick-replies/7275" \
  -H "X-Api-Key: YOUR_API_KEY"

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

Terminal 
curl -X DELETE "https://vibecode.bitrix24.tech/v1/openline-configs/1/quick-replies/7275" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"

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

javascript 
const res = await fetch(
  'https://vibecode.bitrix24.tech/v1/openline-configs/1/quick-replies/7275',
  { method: 'DELETE', headers: { 'X-Api-Key': 'YOUR_API_KEY' } }
)
const { success, data } = await res.json()
console.log(data.deleted)

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

javascript 
const res = await fetch(
  'https://vibecode.bitrix24.tech/v1/openline-configs/1/quick-replies/7275',
  {
    method: 'DELETE',
    headers: {
      'X-Api-Key': 'YOUR_APP_KEY',
      'Authorization': 'Bearer USER_SESSION_TOKEN',
    },
  }
)
const { success, data } = await res.json()
console.log(data.deleted)

Поля ответа

Поле Тип Описание
Полеsuccess Типboolean Описаниеtrue при успешном удалении
Полеdata.id Типinteger ОписаниеID удалённого быстрого ответа
Полеdata.deleted Типboolean ОписаниеВсегда true

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

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

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

404 — в линии lineId нет быстрого ответа с таким id:

JSON 
{
  "success": false,
  "error": {
    "code": "ENTITY_NOT_FOUND",
    "message": "Quick reply not found in this line"
  }
}

Ошибки

HTTP Код Описание
HTTP400 КодINVALID_PARAMS ОписаниеlineId или id не является положительным целым числом
HTTP400 КодINVALID_PARAMS ОписаниеПередано тело запроса, которое не является JSON-объектом
HTTP400 КодINVALID_JSON_BODY ОписаниеПередано тело запроса, которое не разбирается как JSON
HTTP401 КодMISSING_API_KEY ОписаниеНе передан заголовок X-Api-Key
HTTP401 КодTOKEN_MISSING ОписаниеУ ключа нет авторизации на портале Битрикс24. Для ключа приложения — не передан Authorization: Bearer
HTTP403 КодSCOPE_DENIED ОписаниеКлючу не хватает скоупа imopenlines
HTTP403 КодWRITE_BLOCKED_READONLY_KEY ОписаниеКлюч в режиме «только чтение»
HTTP403 КодBITRIX_ACCESS_DENIED ОписаниеСотруднику, от имени которого идёт вызов, закрыт просмотр быстрых ответов этой линии
HTTP403 КодBITRIX_ACCESS_DENIED ОписаниеБитрикс24 отказал сотруднику в доступе к удалению
HTTP404 КодENTITY_NOT_FOUND ОписаниеСообщение Quick reply not found in this line: в линии нет ответа с таким id. Так же отвечает запрос с id ответа другой линии и повторное удаление
HTTP404 КодENTITY_NOT_FOUND ОписаниеСообщение Record not found: открытой линии с таким lineId нет
HTTP422 КодBITRIX_ERROR ОписаниеБитрикс24 вернул ошибку, текст — в message
HTTP429 КодRATE_LIMITED ОписаниеПревышен собственный лимит метода. Общий потолок платформы — 120 запросов в минуту на портал, он делится между репликами платформы, поэтому код может прийти раньше 120-го запроса. Действующее значение — в заголовке x-ratelimit-limit
HTTP502 КодOPENLINE_OPERATOR_FAILED ОписаниеБитрикс24 не подтвердил удаление или вернул список ответов линии в неожиданной форме. Перед повтором проверьте список быстрых ответов
HTTP502 КодBITRIX_UNAVAILABLE ОписаниеПортал Битрикс24 недоступен
HTTP503 КодBITRIX_TIMEOUT ОписаниеБитрикс24 не ответил вовремя, итог неизвестен. Перед повтором проверьте список быстрых ответов

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

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