[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-entities\u002Ftask-comments\u002Fcreate":3,"docs-tabs-entities\u002Ftask-comments\u002Fcreate":6},{"content":4,"lastmod":5},"\n## Создать комментарий\n\n`POST \u002Fv1\u002Ftasks\u002F:taskId\u002Fcomments`\n\nДобавляет комментарий к задаче. На новой карточке задачи сообщение отправляется в чат, на старой — попадает в блок комментариев в самой карточке.\n\n## Параметры\n\n| Параметр | Тип | Обяз. | Описание |\n|----------|-----|:-----:|---------|\n| `taskId` (path) | number | да | ID задачи |\n\n## Поля запроса (body)\n\n| Поле | Тип | Обяз. | Описание |\n|------|-----|:-----:|---------|\n| `message` | string | ★ | Текст комментария, до 65 535 символов. Поддерживает BB-код (`[USER=ID]Имя[\u002FUSER]`, `[B]...[\u002FB]`, `[QUOTE]...[\u002FQUOTE]`) |\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl -X POST \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ftasks\u002F289\u002Fcomments\" \\\n  -H \"X-Api-Key: YOUR_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"message\": \"Добавил черновик отчёта — посмотри, пожалуйста.\"\n  }'\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl -X POST \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ftasks\u002F289\u002Fcomments\" \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"message\": \"Добавил черновик отчёта — посмотри, пожалуйста.\"\n  }'\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ftasks\u002F289\u002Fcomments', {\n  method: 'POST',\n  headers: {\n    'X-Api-Key': 'YOUR_API_KEY',\n    'Content-Type': 'application\u002Fjson',\n  },\n  body: JSON.stringify({\n    message: 'Добавил черновик отчёта — посмотри, пожалуйста.',\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\u002Ftasks\u002F289\u002Fcomments', {\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    message: 'Добавил черновик отчёта — посмотри, пожалуйста.',\n  }),\n})\n\nconst { success, data } = await res.json()\n```\n\n## Поля ответа\n\n| Поле | Тип | Описание |\n|------|-----|---------|\n| `success` | boolean | Всегда `true` при успехе |\n| `data.id` | number \\| null | Идентификатор нового комментария. На новой карточке возвращается id чат-сообщения, в редком случае может быть `null` — см. «Известные особенности» |\n\n## Пример ответа\n\nHTTP 201 Created:\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"id\": 36559\n  }\n}\n```\n\n## Пример ответа при ошибке\n\n400 — пустой или отсутствующий `message`:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"INVALID_PARAMS\",\n    \"message\": \"`message` is required and must be a string\"\n  }\n}\n```\n\n404 — задача не существует или недоступна:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"TASK_NOT_FOUND\",\n    \"message\": \"Bitrix24 did not create the comment (returned false). Task 99999999 may not exist or may not be accessible.\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|---------|\n| 400 | `INVALID_PARAMS` | `taskId` не положительное целое |\n| 400 | `INVALID_PARAMS` | Поле `message` отсутствует или не является строкой |\n| 400 | `INVALID_PARAMS` | `message` превышает лимит длины |\n| 403 | `SCOPE_DENIED` | API-ключ не имеет скоупа `task` |\n| 401 | `TOKEN_MISSING` | API-ключ не имеет настроенных токенов |\n| 404 | `TASK_NOT_FOUND` | Задача `taskId` не существует или недоступна ключу — Битрикс24 не создал комментарий |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Известные особенности\n\n**`data.id` изредка бывает `null` при успехе (`success: true`).** На новой карточке задачи комментарий уходит в чат (`tasks.task.chat.message.send`), а id восстанавливается отдельным поиском по последним сообщениям чата. Если восстановить id не удалось (сообщение не нашлось в окне поиска), комментарий **уже создан**, но ответ возвращает `id: null` — это не ошибка, повторный запрос создаст дубликат. Если же Битрикс24 в принципе не создал комментарий (задача не существует или недоступна), это отдельный случай — API возвращает `404 TASK_NOT_FOUND`, а не `201` с `id: null`.\n\n## Смотрите также\n\n- [Список комментариев](.\u002Flist.md) — найти добавленный комментарий\n- [Получить комментарий](.\u002Fget.md) — прочитать по `id`\n- [Пакет операций](.\u002Fcomments-batch.md) — добавить несколько комментариев одним запросом\n- [Задачи](\u002Fdocs\u002Fentities\u002Ftasks) — родительская сущность\n- [Лимиты и оптимизация](\u002Fdocs\u002Foptimization) — rate limits\n","2026-07-14",{}]