[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-timeline-logs\u002Fnotes\u002Fdelete":3,"docs-tabs-timeline-logs\u002Fnotes\u002Fdelete":6},{"content":4,"lastmod":5},"\n## Удалить заметку\n\n`DELETE \u002Fv1\u002Ftimeline-logs\u002F:id\u002Fnote`\n\nУдаляет заметку, прикреплённую к элементу таймлайна. Параметры передаются в **query string**, не в теле запроса.\n\n## Параметры\n\n| Параметр | Тип | Обяз. | По умолч. | Описание |\n|----------|-----|:-----:|-----------|---------|\n| `id` (path) | number | да | — | ID лог-записи (или другого элемента таймлайна) |\n| `entityTypeId` (query) | number | да | — | Тип родительской CRM-сущности |\n| `entityId` (query) | number | да | — | ID родительской записи |\n| `itemType` (query) | number | нет | `1` | `1` — запись истории, `2` — дело |\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl -X DELETE \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ftimeline-logs\u002F5012\u002Fnote?entityTypeId=2&entityId=100\" \\\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\u002Ftimeline-logs\u002F5012\u002Fnote?entityTypeId=2&entityId=100\" \\\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(\n  'https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ftimeline-logs\u002F5012\u002Fnote?entityTypeId=2&entityId=100',\n  {\n    method: 'DELETE',\n    headers: { 'X-Api-Key': 'YOUR_API_KEY' },\n  },\n)\n\nconst { success, data } = await res.json()\nif (success) console.log('Заметка удалена')\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst res = await fetch(\n  'https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ftimeline-logs\u002F5012\u002Fnote?entityTypeId=2&entityId=100',\n  {\n    method: 'DELETE',\n    headers: {\n      'X-Api-Key': 'YOUR_APP_KEY',\n      'Authorization': 'Bearer USER_SESSION_TOKEN',\n    },\n  },\n)\n\nconst { success, data } = await res.json()\n```\n\n## Поля ответа\n\n| Поле | Тип | Описание |\n|------|-----|---------|\n| `success` | boolean | Всегда `true` при успехе |\n| `data.deleted` | boolean | Всегда `true` — подтверждение операции |\n\n## Пример ответа\n\nHTTP 200:\n\n```json\n{\n  \"success\": true,\n  \"data\": { \"deleted\": true }\n}\n```\n\n## Пример ответа при ошибке\n\n400 — параметры переданы в body вместо query:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"INVALID_PARAMS\",\n    \"message\": \"Required query: entityTypeId, entityId (positive ints). Optional: itemType (default 1)\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|---------|\n| 400 | `INVALID_PARAMS` | Параметры не переданы, переданы некорректно или передан body вместо query |\n| 422 | `BITRIX_ERROR` | Битрикс24 отклонил запрос |\n| 403 | `SCOPE_DENIED` | API-ключ не имеет скоупа `crm` |\n| 401 | `TOKEN_MISSING` | API-ключ не имеет настроенных токенов |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Известные особенности\n\n**Не путать с `DELETE \u002Fv1\u002Ftimeline-logs\u002F:id`.** Там удаляется лог-запись целиком, параметров нет вообще. Здесь — удаление только заметки у элемента, нужны `entityTypeId` + `entityId`.\n\n**Идемпотентность не гарантирована.** Повторное удаление уже удалённой заметки может вернуть ошибку. Если важно сделать вызов идемпотентным — сначала проверьте через [`GET \u002Fv1\u002Ftimeline-logs\u002F:id\u002Fnote`](\u002Fdocs\u002Ftimeline-logs\u002Fnotes\u002Fget): `404 NOTE_NOT_FOUND` означает «уже нет, удалять нечего».\n\n**Не валидирует существование `:id` лог-записи.** На несуществующий `id` `delete` тоже возвращает `200 + {deleted: true}` без ошибки — silently no-op. Тоже стоит сначала проверить через `GET`.\n\n**Удаление заметки доступно любому ключу.** В отличие от `DELETE \u002Fv1\u002Ftimeline-logs\u002F:id` (где работает только тот же OAuth-ключ, который создал лог-запись), удаление заметки работает с любого ключа — независимо от того, кто её создал.\n\n## Смотрите также\n\n- [Получить заметку](\u002Fdocs\u002Ftimeline-logs\u002Fnotes\u002Fget) — проверить существование перед удалением\n- [Сохранить заметку](\u002Fdocs\u002Ftimeline-logs\u002Fnotes\u002Fsave) — создать заново после удаления\n- [Удалить лог-запись](\u002Fdocs\u002Ftimeline-logs\u002Flogs\u002Fdelete) — удалить родительский item целиком (заметка удалится вместе с ним)\n","2026-06-23",{}]