[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-lists\u002Fsections":3,"docs-tabs-lists\u002Fsections":6},{"content":4,"lastmod":5},"# Разделы\n\nГруппируйте элементы списка по разделам: получайте список разделов, создавайте новые, изменяйте и удаляйте. Разделы допускают вложенность — у раздела может быть родитель.\n\nБитрикс24 API: `lists.section.*`\nСкоуп: `lists`\n\n## Операции\n\n- [Разделы списка](.\u002Fsections\u002Flist.md) — `GET \u002Fv1\u002Flists\u002F:iblockId\u002Fsections`\n- [Получить раздел](.\u002Fsections\u002Fget.md) — `GET \u002Fv1\u002Flists\u002F:iblockId\u002Fsections\u002F:sectionId`\n- [Создать раздел](.\u002Fsections\u002Fcreate.md) — `POST \u002Fv1\u002Flists\u002F:iblockId\u002Fsections`\n- [Обновить раздел](.\u002Fsections\u002Fupdate.md) — `PATCH \u002Fv1\u002Flists\u002F:iblockId\u002Fsections\u002F:sectionId`\n- [Удалить раздел](.\u002Fsections\u002Fdelete.md) — `DELETE \u002Fv1\u002Flists\u002F:iblockId\u002Fsections\u002F:sectionId`\n\n## Смотрите также\n\n- [Универсальные списки](\u002Fdocs\u002Flists)\n- [Списки](\u002Fdocs\u002Flists\u002Flists)\n- [Элементы](\u002Fdocs\u002Flists\u002Felements)\n","2026-07-07",{"sections\u002Flist.md":7,"sections\u002Fget.md":8,"sections\u002Fcreate.md":9,"sections\u002Fupdate.md":10,"sections\u002Fdelete.md":11},"## Разделы списка\n\n`GET \u002Fv1\u002Flists\u002F:iblockId\u002Fsections`\n\nВозвращает разделы указанного списка. Разделы группируют элементы и могут образовывать дерево — у раздела бывает родительский раздел.\n\n## Параметры\n\n| Параметр | Тип | Обяз. | По умолч. | Описание |\n|----------|-----|:-----:|:---------:|---------|\n| `iblockId` (path) | string | да | — | Числовой `IBLOCK_ID` или символьный код списка. Идентификаторы доступны через `GET \u002Fv1\u002Flists` |\n| `iblockTypeId` (query) | string | нет | `lists` | Тип инфоблока. Значения:\u003Cbr>`lists` — обычные списки, по умолчанию\u003Cbr>`lists_socnet` — списки рабочих групп\u003Cbr>`bitrix_processes` — служебные бизнес-процессы |\n| `filter` (query) | object | нет | — | Фильтрация по полям раздела — `ID`, `NAME`, `CODE`, `IBLOCK_SECTION_ID`, `SORT`.\u003Cbr>[Синтаксис фильтрации](\u002Fdocs\u002Ffiltering). Пример: `?filter={\"NAME\":\"Документы\"}` |\n| `select` (query) | string | нет | — | Список возвращаемых полей через запятую. Пример: `?select=ID,NAME,CODE` |\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Flists\u002F121\u002Fsections \\\n  -H \"X-Api-Key: YOUR_API_KEY\"\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Flists\u002F121\u002Fsections \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\"\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Flists\u002F121\u002Fsections', {\n  headers: { 'X-Api-Key': 'YOUR_API_KEY' },\n})\nconst { data, meta } = await res.json()\nconsole.log('Разделов:', meta.total)\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Flists\u002F121\u002Fsections', {\n  headers: {\n    'X-Api-Key': 'YOUR_APP_KEY',\n    'Authorization': 'Bearer USER_SESSION_TOKEN',\n  },\n})\nconst { data } = await res.json()\n```\n\n## Поля ответа\n\nПоля ответа — в форме Битрикс24: ключи в верхнем регистре через подчёркивание, числовые значения приходят строками, незаданные поля — `null`.\n\n| Поле | Тип | Описание |\n|------|-----|---------|\n| `success` | boolean | Всегда `true` при успехе |\n| `data` | array | Массив разделов |\n| `data[].ID` | string | Идентификатор раздела |\n| `data[].NAME` | string | Название раздела |\n| `data[].IBLOCK_SECTION_ID` | string | Идентификатор родительского раздела. Приходит `null` у корневого раздела |\n| `data[].SORT` | string | Индекс сортировки |\n| `data[].CODE` | string | Символьный код раздела |\n| `meta.total` | number | Общее количество разделов, соответствующих запросу |\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": [\n    {\n      \"ID\": \"137\",\n      \"NAME\": \"Документы отдела продаж\",\n      \"IBLOCK_SECTION_ID\": null,\n      \"SORT\": \"100\",\n      \"CODE\": \"sales_docs\"\n    },\n    {\n      \"ID\": \"139\",\n      \"NAME\": \"Документы отдела маркетинга\",\n      \"IBLOCK_SECTION_ID\": null,\n      \"SORT\": \"200\",\n      \"CODE\": \"marketing_docs\"\n    }\n  ],\n  \"meta\": { \"total\": 2 }\n}\n```\n\n## Пример ответа при ошибке\n\n400 — параметр `filter` не является корректным JSON:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"INVALID_FILTER\",\n    \"message\": \"filter must be valid JSON, e.g. filter={\\\"NAME\\\":\\\"%urgent%\\\"}.\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|---------|\n| 400 | `INVALID_FILTER` | `filter` не является корректным JSON |\n| 400 | `INVALID_IBLOCK_TYPE` | `iblockTypeId` не входит в допустимый набор |\n| 403 | `BITRIX_ACCESS_DENIED` | Нет прав на список либо списка с таким идентификатором не существует |\n| 409 | `LISTS_MODULE_NOT_ENABLED` | Модуль «Списки» не подключён на портале |\n| 403 | `SCOPE_DENIED` | У API-ключа нет скоупа `lists` |\n| 401 | `TOKEN_MISSING` | У API-ключа нет настроенных токенов |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Известные особенности\n\n**Дерево восстанавливается по `IBLOCK_SECTION_ID`.** Разделы приходят плоским массивом. Чтобы построить дерево, сгруппируйте разделы по значению `IBLOCK_SECTION_ID`: у корневых оно равно `null`, у вложенных — идентификатору родительского раздела.\n\n## Смотрите также\n\n- [Получить раздел](\u002Fdocs\u002Flists\u002Fsections\u002Fget)\n- [Создать раздел](\u002Fdocs\u002Flists\u002Fsections\u002Fcreate)\n- [Разделы](\u002Fdocs\u002Flists\u002Fsections)\n- [Синтаксис фильтрации](\u002Fdocs\u002Ffiltering)\n","## Получить раздел\n\n`GET \u002Fv1\u002Flists\u002F:iblockId\u002Fsections\u002F:sectionId`\n\nВозвращает полные метаданные одного раздела списка по его числовому идентификатору.\n\n## Параметры\n\n| Параметр | Тип | Обяз. | По умолч. | Описание |\n|----------|-----|:-----:|:---------:|---------|\n| `iblockId` (path) | string | да | — | Числовой `IBLOCK_ID` или символьный код списка. Идентификаторы доступны через `GET \u002Fv1\u002Flists` |\n| `sectionId` (path) | number | да | — | Числовой идентификатор раздела. Идентификаторы доступны через `GET \u002Fv1\u002Flists\u002F:iblockId\u002Fsections` |\n| `iblockTypeId` (query) | string | нет | `lists` | Тип инфоблока. Значения:\u003Cbr>`lists` — обычные списки, по умолчанию\u003Cbr>`lists_socnet` — списки рабочих групп\u003Cbr>`bitrix_processes` — служебные бизнес-процессы |\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Flists\u002F121\u002Fsections\u002F137 \\\n  -H \"X-Api-Key: YOUR_API_KEY\"\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Flists\u002F121\u002Fsections\u002F137 \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\"\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Flists\u002F121\u002Fsections\u002F137', {\n  headers: { 'X-Api-Key': 'YOUR_API_KEY' },\n})\nconst { data } = await res.json()\nconsole.log('Раздел:', data.NAME)\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Flists\u002F121\u002Fsections\u002F137', {\n  headers: {\n    'X-Api-Key': 'YOUR_APP_KEY',\n    'Authorization': 'Bearer USER_SESSION_TOKEN',\n  },\n})\nconst { data } = await res.json()\n```\n\n## Поля ответа\n\nПоля ответа — в форме Битрикс24: ключи в верхнем регистре через подчёркивание, числовые значения и флаги (`Y`\u002F`N`) приходят строками, незаданные поля — `null`.\n\n| Поле | Тип | Описание |\n|------|-----|---------|\n| `success` | boolean | Всегда `true` при успехе |\n| `data.ID` | string | Идентификатор раздела |\n| `data.NAME` | string | Название раздела |\n| `data.CODE` | string | Символьный код раздела |\n| `data.IBLOCK_ID` | string | Идентификатор списка, которому принадлежит раздел |\n| `data.IBLOCK_SECTION_ID` | string | Идентификатор родительского раздела. Приходит `null` у корневого раздела |\n| `data.SORT` | string | Индекс сортировки |\n| `data.ACTIVE` | string | Активность раздела: `Y` или `N` |\n| `data.GLOBAL_ACTIVE` | string | Действующая активность с учётом родительских разделов: `Y` или `N` |\n| `data.DEPTH_LEVEL` | string | Уровень вложенности. `1` у корневого раздела |\n| `data.LEFT_MARGIN` | string | Левая граница поддерева в модели вложенных множеств |\n| `data.RIGHT_MARGIN` | string | Правая граница поддерева в модели вложенных множеств |\n| `data.DESCRIPTION` | string | Описание раздела |\n| `data.DESCRIPTION_TYPE` | string | Формат описания: `text` или `html` |\n| `data.DATE_CREATE` | string | Дата создания |\n| `data.CREATED_BY` | string | Идентификатор сотрудника, создавшего раздел |\n| `data.MODIFIED_BY` | string | Идентификатор сотрудника, изменившего раздел последним |\n\nПоказаны основные поля. Объект раздела содержит и другие поля метаданных инфоблока Битрикс24.\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"ID\": \"137\",\n    \"NAME\": \"Документы отдела продаж\",\n    \"CODE\": \"sales_docs\",\n    \"IBLOCK_ID\": \"121\",\n    \"IBLOCK_SECTION_ID\": null,\n    \"ACTIVE\": \"Y\",\n    \"GLOBAL_ACTIVE\": \"Y\",\n    \"SORT\": \"100\",\n    \"DEPTH_LEVEL\": \"1\",\n    \"LEFT_MARGIN\": \"1\",\n    \"RIGHT_MARGIN\": \"2\",\n    \"DESCRIPTION\": \"Описание раздела\",\n    \"DESCRIPTION_TYPE\": \"html\",\n    \"DATE_CREATE\": \"10\u002F22\u002F2025 04:22:38 am\",\n    \"CREATED_BY\": \"1\",\n    \"MODIFIED_BY\": \"1\",\n    \"TIMESTAMP_X\": null,\n    \"PICTURE\": null,\n    \"IBLOCK_TYPE_ID\": \"lists\"\n  }\n}\n```\n\n## Пример ответа при ошибке\n\n404 — раздел не найден:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"SECTION_NOT_FOUND\",\n    \"message\": \"Section not found\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|---------|\n| 400 | `INVALID_PARAMS` | `sectionId` не является положительным целым числом |\n| 400 | `INVALID_IBLOCK_TYPE` | `iblockTypeId` не входит в допустимый набор |\n| 404 | `SECTION_NOT_FOUND` | Раздел с указанным `sectionId` не найден |\n| 403 | `BITRIX_ACCESS_DENIED` | Нет прав на список либо списка с таким идентификатором не существует |\n| 409 | `LISTS_MODULE_NOT_ENABLED` | Модуль «Списки» не подключён на портале |\n| 403 | `SCOPE_DENIED` | У API-ключа нет скоупа `lists` |\n| 401 | `TOKEN_MISSING` | У API-ключа нет настроенных токенов |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Известные особенности\n\n**Положение раздела в дереве задаётся тремя полями.** `DEPTH_LEVEL` — уровень вложенности, `1` у корневого раздела. `LEFT_MARGIN` и `RIGHT_MARGIN` — границы поддерева в модели вложенных множеств. По ним Битрикс24 определяет потомков раздела: раздел является потомком другого, если его границы лежат внутри границ предка.\n\n**`ACTIVE` и `GLOBAL_ACTIVE` различаются.** `ACTIVE` — собственная активность раздела. `GLOBAL_ACTIVE` учитывает родительские разделы: если родитель отключён, у потомка приходит `GLOBAL_ACTIVE` равный `N` даже при `ACTIVE` равном `Y`.\n\n## Смотрите также\n\n- [Разделы списка](\u002Fdocs\u002Flists\u002Fsections\u002Flist)\n- [Обновить раздел](\u002Fdocs\u002Flists\u002Fsections\u002Fupdate)\n- [Удалить раздел](\u002Fdocs\u002Flists\u002Fsections\u002Fdelete)\n","\n## Создать раздел\n\n`POST \u002Fv1\u002Flists\u002F:iblockId\u002Fsections`\n\nСоздаёт новый раздел в списке. Символьный код раздела передаётся полем `sectionCode` на верхнем уровне тела, вне обёртки `fields`, а поля раздела идут внутри `fields` в форме Битрикс24.\n\n## Параметры\n\n| Параметр | Тип | Обяз. | Описание |\n|----------|-----|:-----:|---------|\n| `iblockId` (path) | string | да | Числовой `IBLOCK_ID` или символьный код списка |\n\n## Поля запроса (body)\n\n| Поле | Тип | Обяз. | Описание |\n|------|-----|:-----:|---------|\n| `sectionCode` | string | да | Символьный код нового раздела. Передаётся на верхнем уровне тела, вне обёртки `fields` |\n| `fields` | object | да | Поля раздела в форме Битрикс24. Ключи внутри — в верхнем регистре с подчёркиванием |\n| `fields.NAME` | string | да | Название раздела |\n| `fields.SORT` | number | нет | Индекс сортировки в перечне разделов |\n| `fields.DESCRIPTION` | string | нет | Описание раздела |\n| `iblockSectionId` | number | нет | ID родительского раздела для вложенности. Значение `0` или отсутствие поля — раздел создаётся в корне списка. Список разделов: `GET \u002Fv1\u002Flists\u002F:iblockId\u002Fsections` |\n| `iblockTypeId` | string | нет | Тип инфоблока. Значения:\u003Cbr>`lists` — обычные списки, по умолчанию\u003Cbr>`lists_socnet` — списки рабочих групп\u003Cbr>`bitrix_processes` — служебные бизнес-процессы |\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl -X POST https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Flists\u002F23\u002Fsections \\\n  -H \"X-Api-Key: YOUR_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"sectionCode\": \"region_north\",\n    \"fields\": {\n      \"NAME\": \"Северный регион\",\n      \"SORT\": 100,\n      \"DESCRIPTION\": \"Заявки по северному региону\"\n    }\n  }'\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl -X POST https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Flists\u002F23\u002Fsections \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"sectionCode\": \"region_north\",\n    \"fields\": {\n      \"NAME\": \"Северный регион\",\n      \"SORT\": 100,\n      \"DESCRIPTION\": \"Заявки по северному региону\"\n    }\n  }'\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Flists\u002F23\u002Fsections', {\n  method: 'POST',\n  headers: {\n    'X-Api-Key': 'YOUR_API_KEY',\n    'Content-Type': 'application\u002Fjson',\n  },\n  body: JSON.stringify({\n    sectionCode: 'region_north',\n    fields: {\n      NAME: 'Северный регион',\n      SORT: 100,\n      DESCRIPTION: 'Заявки по северному региону',\n    },\n  }),\n})\n\nconst { data } = await res.json()\nconsole.log('ID раздела:', data.id)\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Flists\u002F23\u002Fsections', {\n  method: 'POST',\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    sectionCode: 'region_north',\n    fields: {\n      NAME: 'Северный регион',\n      SORT: 100,\n      DESCRIPTION: 'Заявки по северному региону',\n    },\n  }),\n})\n\nconst { data } = await res.json()\n```\n\n## Поля ответа\n\n| Поле | Тип | Описание |\n|------|-----|---------|\n| `success` | boolean | Всегда `true` при успехе |\n| `data.id` | number | Идентификатор созданного раздела |\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"id\": 215\n  }\n}\n```\n\n## Пример ответа при ошибке\n\n400 — не передан обязательный параметр:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"MISSING_REQUIRED_FIELDS\",\n    \"message\": \"`sectionCode` is required (the symbolic code of the new section).\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|---------|\n| 400 | `MISSING_REQUIRED_FIELDS` | Не передан `sectionCode` или объект `fields` |\n| 400 | `INVALID_IBLOCK_TYPE` | `iblockTypeId` не входит в набор `lists`, `lists_socnet`, `bitrix_processes` |\n| 403 | `BITRIX_ACCESS_DENIED` | Список не существует или у ключа нет прав на него |\n| 409 | `LISTS_MODULE_NOT_ENABLED` | На портале Битрикс24 не подключён модуль «Списки» |\n| 403 | `WRITE_BLOCKED_READONLY_KEY` | Ключ работает в режиме только чтения |\n| 403 | `SCOPE_DENIED` | Ключу не хватает скоупа `lists` |\n| 401 | `TOKEN_MISSING` | У ключа не настроены токены доступа |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Известные особенности\n\n**Вложенность через `iblockSectionId`.** Раздел размещается внутри другого раздела, когда в `iblockSectionId` передан ID родителя. Без этого поля или при значении `0` раздел создаётся на верхнем уровне списка.\n\n## Смотрите также\n\n- [Обновить раздел](\u002Fdocs\u002Flists\u002Fsections\u002Fupdate)\n- [Удалить раздел](\u002Fdocs\u002Flists\u002Fsections\u002Fdelete)\n- [Разделы](\u002Fdocs\u002Flists\u002Fsections)\n- [Элементы](\u002Fdocs\u002Flists\u002Felements)\n","\n## Обновить раздел\n\n`PATCH \u002Fv1\u002Flists\u002F:iblockId\u002Fsections\u002F:sectionId`\n\nИзменяет поля существующего раздела списка. Изменяемые поля передаются внутри объекта `fields` в форме Битрикс24.\n\n## Параметры\n\n| Параметр | Тип | Обяз. | Описание |\n|----------|-----|:-----:|---------|\n| `iblockId` (path) | string | да | Числовой `IBLOCK_ID` или символьный код списка |\n| `sectionId` (path) | number | да | Числовой идентификатор раздела. Список разделов: `GET \u002Fv1\u002Flists\u002F:iblockId\u002Fsections` |\n\n## Поля запроса (body)\n\n| Поле | Тип | Обяз. | Описание |\n|------|-----|:-----:|---------|\n| `fields` | object | да | Изменяемые поля раздела в форме Битрикс24. Ключи внутри — в верхнем регистре с подчёркиванием, например `NAME`, `SORT`, `DESCRIPTION` |\n| `iblockTypeId` | string | нет | Тип инфоблока. Значения:\u003Cbr>`lists` — обычные списки, по умолчанию\u003Cbr>`lists_socnet` — списки рабочих групп\u003Cbr>`bitrix_processes` — служебные бизнес-процессы |\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl -X PATCH https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Flists\u002F23\u002Fsections\u002F215 \\\n  -H \"X-Api-Key: YOUR_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"fields\": {\n      \"NAME\": \"Северо-Западный регион\",\n      \"SORT\": 200\n    }\n  }'\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl -X PATCH https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Flists\u002F23\u002Fsections\u002F215 \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"fields\": {\n      \"NAME\": \"Северо-Западный регион\",\n      \"SORT\": 200\n    }\n  }'\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Flists\u002F23\u002Fsections\u002F215', {\n  method: 'PATCH',\n  headers: {\n    'X-Api-Key': 'YOUR_API_KEY',\n    'Content-Type': 'application\u002Fjson',\n  },\n  body: JSON.stringify({\n    fields: {\n      NAME: 'Северо-Западный регион',\n      SORT: 200,\n    },\n  }),\n})\n\nconst { data } = await res.json()\nconsole.log(data.updated)\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Flists\u002F23\u002Fsections\u002F215', {\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    fields: {\n      NAME: 'Северо-Западный регион',\n      SORT: 200,\n    },\n  }),\n})\n\nconst { data } = await res.json()\n```\n\n## Поля ответа\n\n| Поле | Тип | Описание |\n|------|-----|---------|\n| `success` | boolean | Всегда `true` при успехе |\n| `data.updated` | boolean | `true` при успешном обновлении |\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"updated\": true\n  }\n}\n```\n\n## Пример ответа при ошибке\n\n400 — не передан обязательный параметр:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"MISSING_REQUIRED_FIELDS\",\n    \"message\": \"`fields` is required and must be an object.\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|---------|\n| 400 | `INVALID_PARAMS` | `sectionId` не является положительным целым числом |\n| 400 | `MISSING_REQUIRED_FIELDS` | Не передан объект `fields` |\n| 400 | `INVALID_IBLOCK_TYPE` | `iblockTypeId` не входит в набор `lists`, `lists_socnet`, `bitrix_processes` |\n| 403 | `BITRIX_ACCESS_DENIED` | Раздел или список не существует, либо у ключа нет прав на него |\n| 409 | `LISTS_MODULE_NOT_ENABLED` | На портале Битрикс24 не подключён модуль «Списки» |\n| 403 | `WRITE_BLOCKED_READONLY_KEY` | Ключ работает в режиме только чтения |\n| 403 | `SCOPE_DENIED` | Ключу не хватает скоупа `lists` |\n| 401 | `TOKEN_MISSING` | У ключа не настроены токены доступа |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Смотрите также\n\n- [Создать раздел](\u002Fdocs\u002Flists\u002Fsections\u002Fcreate)\n- [Удалить раздел](\u002Fdocs\u002Flists\u002Fsections\u002Fdelete)\n- [Разделы](\u002Fdocs\u002Flists\u002Fsections)\n- [Элементы](\u002Fdocs\u002Flists\u002Felements)\n","\n## Удалить раздел\n\n`DELETE \u002Fv1\u002Flists\u002F:iblockId\u002Fsections\u002F:sectionId`\n\nУдаляет раздел списка. Восстановить удалённый раздел через API нельзя — создавайте новый при необходимости.\n\n## Параметры\n\n| Параметр | Тип | Обяз. | Описание |\n|----------|-----|:-----:|---------|\n| `iblockId` (path) | string | да | Числовой `IBLOCK_ID` или символьный код списка |\n| `sectionId` (path) | number | да | Числовой идентификатор раздела. Список разделов: `GET \u002Fv1\u002Flists\u002F:iblockId\u002Fsections` |\n| `iblockTypeId` (query) | string | нет | Тип инфоблока. Значения:\u003Cbr>`lists` — обычные списки, по умолчанию\u003Cbr>`lists_socnet` — списки рабочих групп\u003Cbr>`bitrix_processes` — служебные бизнес-процессы |\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl -X DELETE https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Flists\u002F23\u002Fsections\u002F215 \\\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\u002Flists\u002F23\u002Fsections\u002F215 \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\"\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Flists\u002F23\u002Fsections\u002F215', {\n  method: 'DELETE',\n  headers: { 'X-Api-Key': 'YOUR_API_KEY' },\n})\nif (res.status === 204) {\n  console.log('Раздел удалён')\n}\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Flists\u002F23\u002Fsections\u002F215', {\n  method: 'DELETE',\n  headers: {\n    'X-Api-Key': 'YOUR_APP_KEY',\n    'Authorization': 'Bearer USER_SESSION_TOKEN',\n  },\n})\nif (res.status === 204) {\n  console.log('Раздел удалён')\n}\n```\n\n## Ответ\n\nПри успешном удалении возвращается HTTP-статус `204 No Content` с пустым телом. Признак успеха — код ответа, не содержимое.\n\n## Пример ответа\n\n```\nHTTP\u002F1.1 204 No Content\n```\n\n## Пример ответа при ошибке\n\n400 — некорректный идентификатор раздела:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"INVALID_PARAMS\",\n    \"message\": \"sectionId must be a positive integer\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|---------|\n| 400 | `INVALID_PARAMS` | `sectionId` не является положительным целым числом |\n| 400 | `INVALID_IBLOCK_TYPE` | `iblockTypeId` не входит в набор `lists`, `lists_socnet`, `bitrix_processes` |\n| 403 | `BITRIX_ACCESS_DENIED` | Раздел или список не существует, либо у ключа нет прав на него |\n| 409 | `LISTS_MODULE_NOT_ENABLED` | На портале Битрикс24 не подключён модуль «Списки» |\n| 403 | `WRITE_BLOCKED_READONLY_KEY` | Ключ работает в режиме только чтения |\n| 403 | `SCOPE_DENIED` | Ключу не хватает скоупа `lists` |\n| 401 | `TOKEN_MISSING` | У ключа не настроены токены доступа |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Смотрите также\n\n- [Создать раздел](\u002Fdocs\u002Flists\u002Fsections\u002Fcreate)\n- [Обновить раздел](\u002Fdocs\u002Flists\u002Fsections\u002Fupdate)\n- [Разделы](\u002Fdocs\u002Flists\u002Fsections)\n- [Элементы](\u002Fdocs\u002Flists\u002Felements)\n"]