---
title: "Написать комментарий к документу"
method: POST
path: "/api/v1/docflow/comments"
tags: ["Docflow flow"]
---

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

`POST /api/v1/docflow/comments`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/docflow/comments`
- 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`)

Пишет комментарий в обсуждение карточки документооборота или заявки на оплату. Комментарий не меняет редакцию документа и не сбрасывает визы согласования. Писать вправе всякий, кто предмет видит (иначе 404). @упоминание: mentioned_user_ids — сотрудники кабинета, чьё «@Имя» (имя как в ответе mention-candidates) стоит в тексте; номер без имени в тексте, себя и не сотрудника кабинета не засчитывают. Упомянутому, который документ видит, уходит уведомление docflow_comment_mention со ссылкой на документ; кто не видит — записан с sees_document=false и уведомления не получает (доступ этим вызовом не выдаётся). Автору документа и участникам текущего прохода согласования — уведомление docflow_comment, не чаще одного на документ за 10 минут на человека. Пустой текст, текст длиннее 4000 знаков или больше 20 упоминаний — 422 docflow.comment.field с полем.

## Headers

- `X-Tenant` string, required

## Request body

- DocflowDocumentCommentInput
  - `subject_kind` 'flow_document' | 'payment_request', required: Вид предмета: flow_document — карточка документооборота, payment_request — заявка на оплату
  - `subject_id` string, uuid, required
  - `body` string, required: Текст комментария; упоминание — «@Имя» в тексте
  - `mentioned_user_ids` integer[]: Упомянутые сотрудники; засчитываются те, чьё «@Имя» стоит в тексте

## Response `201`

Комментарий

- 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`: Запись не найдена или не видима текущему пользователю
- `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/post.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)