[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-telephony\u002Flines\u002Fdelete":3,"docs-tabs-telephony\u002Flines\u002Fdelete":6},{"content":4,"lastmod":5},"\n## Удалить линию\n\n`DELETE \u002Fv1\u002Ftelephony-lines\u002F:number`\n\nУдаляет внешнюю линию приложения по идентификатору `number`. Восстановить удалённую линию через API нельзя — создайте новую с тем же `number` при необходимости.\n\n## Параметры\n\n| Параметр | Тип | Обяз. | Описание |\n|----------|-----|:-----:|---------|\n| `number` (path) | string | да | Идентификатор линии, заданный при создании. Если содержит спецсимволы — URL-кодировать |\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl -X DELETE \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ftelephony-lines\u002Fsip-line-1\" \\\n  -H \"X-Api-Key: YOUR_API_KEY\"\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl -X DELETE \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ftelephony-lines\u002Fsip-line-1\" \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\"\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst number = 'sip-line-1'\nconst res = await fetch(\n  `https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ftelephony-lines\u002F${encodeURIComponent(number)}`,\n  {\n    method: 'DELETE',\n    headers: {\n      'X-Api-Key': 'YOUR_API_KEY',\n    },\n  }\n)\n\nif (res.status === 204) {\n  console.log('Линия удалена')\n}\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst number = 'sip-line-1'\nconst res = await fetch(\n  `https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ftelephony-lines\u002F${encodeURIComponent(number)}`,\n  {\n    method: 'DELETE',\n    headers: {\n      'X-Api-Key': 'YOUR_APP_KEY',\n      'Authorization': 'Bearer USER_SESSION_TOKEN',\n    },\n  }\n)\n\nif (res.status === 204) {\n  console.log('Линия удалена')\n}\n```\n\n## Ответ\n\nПри успешном удалении возвращается HTTP-статус `204 No Content` с пустым телом — успех проверяется по коду ответа.\n\n## Пример ответа\n\n```http\nHTTP\u002F1.1 204 No Content\n```\n\n## Пример ответа при ошибке\n\n422 — ошибка Битрикс24:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"BITRIX_ERROR\",\n    \"message\": \"External line not found\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|---------|\n| 422 | `BITRIX_ERROR` | Битрикс24 вернул ошибку — текст в `error.message`. Возникает в том числе при попытке удалить несуществующую линию |\n| 401 | `MISSING_API_KEY` | Не передан заголовок `X-Api-Key` |\n| 401 | `INVALID_API_KEY` | Неверный API-ключ |\n| 401 | `TOKEN_MISSING` | Ключ не имеет настроенных токенов |\n| 401 | `KEY_INACTIVE` | API-ключ неактивен или отозван |\n| 403 | `SCOPE_DENIED` | Ключу не хватает скоупа `telephony` |\n| 429 | `RATE_LIMITED` | Превышен лимит запросов |\n| 502 | `BITRIX_UNAVAILABLE` | Битрикс24 недоступен |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Смотрите также\n\n- [Список линий приложения](.\u002Flist.md) — найти `number` нужной линии перед удалением\n- [Добавить линию](.\u002Fcreate.md) — создать новую линию с тем же `number`\n- [Обновить линию](.\u002Fupdate.md) — `PATCH \u002Fv1\u002Ftelephony-lines\u002F:number`\n","2026-06-16",{"update.md":7},"\n## Обновить линию\n\n`PATCH \u002Fv1\u002Ftelephony-lines\u002F:number`\n\nОбновляет параметры существующей внешней линии приложения. Идентификатор `number` задаётся при создании и не меняется. Поля передаются плоско в корне JSON — без обёртки `fields`.\n\n## Параметры\n\n| Параметр | Тип | Обяз. | Описание |\n|----------|-----|:-----:|---------|\n| `number` (path) | string | да | Идентификатор линии, заданный при создании. Если содержит спецсимволы — URL-кодировать |\n\n## Поля запроса (body)\n\n| Поле | Тип | Обяз. | Описание |\n|------|-----|:-----:|---------|\n| `name` | string | нет | Новое отображаемое название линии |\n| `crmAutoCreate` | boolean | нет | Автосоздание CRM-сущности при исходящем звонке: `true` \u002F `false` |\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl -X PATCH \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ftelephony-lines\u002Fsip-line-1\" \\\n  -H \"X-Api-Key: YOUR_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"name\": \"Основная линия (обновлено)\"\n  }'\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl -X PATCH \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ftelephony-lines\u002Fsip-line-1\" \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"name\": \"Основная линия (обновлено)\"\n  }'\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst number = 'sip-line-1'\nconst res = await fetch(\n  `https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ftelephony-lines\u002F${encodeURIComponent(number)}`,\n  {\n    method: 'PATCH',\n    headers: {\n      'X-Api-Key': 'YOUR_API_KEY',\n      'Content-Type': 'application\u002Fjson',\n    },\n    body: JSON.stringify({\n      name: 'Основная линия (обновлено)',\n    }),\n  }\n)\n\nconst { success, data } = await res.json()\nconsole.log('Идентификатор линии:', data.id)\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst number = 'sip-line-1'\nconst res = await fetch(\n  `https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ftelephony-lines\u002F${encodeURIComponent(number)}`,\n  {\n    method: 'PATCH',\n    headers: {\n      'X-Api-Key': 'YOUR_APP_KEY',\n      'Authorization': 'Bearer USER_SESSION_TOKEN',\n      'Content-Type': 'application\u002Fjson',\n    },\n    body: JSON.stringify({\n      name: 'Основная линия (обновлено)',\n    }),\n  }\n)\n\nconst { success, data } = await res.json()\n```\n\n## Поля ответа\n\n| Поле | Тип | Описание |\n|------|-----|---------|\n| `success` | boolean | Всегда `true` при успехе |\n| `data.id` | string | Идентификатор обновлённой линии (значение `number` из URL) |\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"id\": \"sip-line-1\"\n  }\n}\n```\n\n## Пример ответа при ошибке\n\n422 — линия не найдена или ошибка Битрикс24:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"BITRIX_ERROR\",\n    \"message\": \"NUMBER should not be empty\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|---------|\n| 422 | `BITRIX_ERROR` | Битрикс24 вернул ошибку — текст в `error.message` |\n| 401 | `MISSING_API_KEY` | Не передан заголовок `X-Api-Key` |\n| 401 | `INVALID_API_KEY` | Неверный API-ключ |\n| 401 | `TOKEN_MISSING` | Ключ не имеет настроенных токенов |\n| 401 | `KEY_INACTIVE` | API-ключ неактивен или отозван |\n| 403 | `SCOPE_DENIED` | Ключу не хватает скоупа `telephony` |\n| 429 | `RATE_LIMITED` | Превышен лимит запросов |\n| 502 | `BITRIX_UNAVAILABLE` | Битрикс24 недоступен |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Известные особенности\n\n**Нужно хотя бы одно обновляемое поле.** Распознаются только `name` и `crmAutoCreate`. Тело без них (пустое или только с нераспознанными полями) отвечает `422 «There are no fields to update»`.\n\n**`serverName` не обновляется.** Поле есть в `GET \u002Fv1\u002Ftelephony-lines\u002Ffields`, но `PATCH` с одним `serverName` отвечает `422 «There are no fields to update»` — оно не распознаётся как обновляемое. Значение не сохраняется и не возвращается в чтении.\n\n**`data.id` — это `number` из URL, не целое число.** В отличие от ответа `POST \u002Fv1\u002Ftelephony-lines`, где `data.id` является внутренним числовым идентификатором записи, ответ обновления возвращает строку — значение `number` из пути запроса.\n\n**Изменить `number` через обновление нельзя.** Идентификатор фиксируется при создании. Чтобы сменить `number` — удалите линию и создайте новую с нужным значением.\n\n## Смотрите также\n\n- [Список линий приложения](.\u002Flist.md) — `GET \u002Fv1\u002Ftelephony-lines`\n- [Добавить линию](.\u002Fcreate.md) — `POST \u002Fv1\u002Ftelephony-lines`\n- [Удалить линию](.\u002Fdelete.md) — `DELETE \u002Fv1\u002Ftelephony-lines\u002F:number`\n"]