[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-note\u002Fcollections\u002Fcreate":3,"docs-tabs-note\u002Fcollections\u002Fcreate":6},{"content":4,"lastmod":5},"## Создать базу знаний\n\n`POST \u002Fv1\u002Fnote\u002Fcollections`\n\nСоздаёт базу знаний — контейнер для документов в Базе знаний 2.0 Битрикс24. Тело передаётся плоско, без обёртки `fields`.\n\n## Поля запроса (body)\n\n| Поле | Тип | Обяз. | Описание |\n|------|-----|:-----:|---------|\n| `name` | string | да | Название базы знаний |\n| `position` | integer | нет | Позиция в списке. Сортировка по убыванию значения. По умолчанию `0` — база знаний размещается в начале списка |\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl -X POST https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fnote\u002Fcollections \\\n  -H \"X-Api-Key: YOUR_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"name\": \"Продуктовая документация\",\n    \"position\": 100\n  }'\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl -X POST https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fnote\u002Fcollections \\\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    \"position\": 100\n  }'\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fnote\u002Fcollections', {\n  method: 'POST',\n  headers: {\n    'X-Api-Key': 'YOUR_API_KEY',\n    'Content-Type': 'application\u002Fjson',\n  },\n  body: JSON.stringify({\n    name: 'Продуктовая документация',\n    position: 100,\n  }),\n})\n\nconst { success, 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\u002Fnote\u002Fcollections', {\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    name: 'Продуктовая документация',\n    position: 100,\n  }),\n})\n\nconst { success, data } = await res.json()\n```\n\n## Поля ответа\n\n| Поле | Тип | Описание |\n|------|-----|---------|\n| `data.id` | number | Идентификатор созданной базы знаний |\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"id\": 42\n  }\n}\n```\n\n## Пример ответа при ошибке\n\n400 — не передан `name`:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"INVALID_PARAMS\",\n    \"message\": \"`name` is required and must be a non-empty string\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|---------|\n| 400 | `INVALID_PARAMS` | Не передан `name`, либо `position` не является неотрицательным целым числом |\n| 403 | `BITRIX_ACCESS_DENIED` | На портале Битрикс24 нет права создавать базы знаний |\n| 502 | `BITRIX_UNAVAILABLE` | Битрикс24 недоступен |\n| 403 | `SCOPE_DENIED` | Ключу не хватает скоупа `note` |\n| 403 | `WRITE_BLOCKED_READONLY_KEY` | Ключ работает в режиме «только чтение» |\n| 401 | `TOKEN_MISSING` | У ключа нет настроенных токенов |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Смотрите также\n\n- [Переименовать базу знаний](\u002Fdocs\u002Fnote\u002Fcollections\u002Fupdate)\n- [Список баз знаний](\u002Fdocs\u002Fnote\u002Fcollections\u002Flist)\n- [Базы знаний](\u002Fdocs\u002Fnote\u002Fcollections)\n","2026-07-08",{}]