---
title: "Исправить свой комментарий к документу"
method: PUT
path: "/api/v1/docflow/comments/{id}"
tags: ["Docflow flow"]
---

# Исправить свой комментарий к документу

`PUT /api/v1/docflow/comments/{id}`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/docflow/comments/{id}`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://erp.akeda.ru/oauth2/authorize`, token URL `https://erp.akeda.ru/oauth2/token`, scopes: `akeda:delegate`)

Заменяет текст и упоминания своего комментария в течение 15 минут после отправки; комментарий получает edited_at. Новым упомянутым, которые видят документ, уходит уведомление; прежним упомянутым и подписчикам документа правка уведомлений не шлёт. Чужой комментарий — 403 docflow.comment.forbidden; окно прошло — 409 docflow.comment.edit_expired; удалённый — 409 docflow.comment.deleted; предмет не виден — 404.

## Path parameters

- `id` string, uuid, required

## Headers

- `X-Tenant` string, required

## Request body

- DocflowDocumentCommentEdit
  - `body` string, required: Новый текст комментария
  - `mentioned_user_ids` integer[]: Упомянутые сотрудники; засчитываются те, чьё «@Имя» стоит в тексте

## Response `200`

Комментарий

- DocflowDocumentComment: Комментарий обсуждения документа. Удалённый (deleted=true) отдаётся без текста и упоминаний.
  - `id` string, uuid, required
  - `subject_kind` 'flow_document' | 'payment_request', required: Вид предмета
  - `subject_id` string, uuid, required
  - `author_id` integer, required: Автор комментария
  - `author_name` string, required: Имя автора
  - `body` string, required: Текст; пусто у удалённого
  - `mentions` DocflowDocumentCommentMention[], required
    - `user_id` integer, required: Упомянутый сотрудник
    - `name` string, required: Имя на момент упоминания
    - `sees_document` boolean, required: Видел ли документ, когда его упомянули; false — уведомление не ушло
  - `created_at` string, date-time, required
  - `edited_at` string, date-time: Когда текст исправили
  - `deleted_at` string, date-time: Когда комментарий удалили
  - `deleted` boolean, required: Комментарий удалён — остался след
  - `can_edit` boolean, required: Смотрящий вправе исправить: свой и не прошло 15 минут
  - `editable_until` string, date-time: До какого времени свой комментарий можно исправить
  - `can_delete` boolean, required: Смотрящий вправе удалить — свой комментарий

## Other responses

- `400`: Некорректный запрос или нарушение бизнес-правила
- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `404`: Запись не найдена или не видима текущему пользователю
- `409`: Конфликт версии, идемпотентности или бизнес-состояния
- `422`: Запрос разобран, но бизнес-значение недопустимо
- `503`: Внешний банк, справочник или контур подключений временно недоступен

## Changes

- **2026-10-20** `765c65fadf8f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/akeda/apis/akeda-erp-client-api/changes/api/v1/docflow/comments/:id/put.md)

---

[API](https://skmtc.dev/akeda/apis/akeda-erp-client-api.md) · [All operations](https://skmtc.dev/akeda/apis/akeda-erp-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/akeda/apis/akeda-erp-client-api/revisions/7a6b75f272ee?raw)