---
title: "Подобрать сотрудника для упоминания в обсуждении"
method: GET
path: "/api/v1/docflow/comments/mention-candidates"
tags: ["Docflow flow"]
---

# Подобрать сотрудника для упоминания в обсуждении

`GET /api/v1/docflow/comments/mention-candidates`

## Request

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

Сотрудники кабинета по части имени (q; пусто — первые по алфавиту), не больше 20, без самого спрашивающего. sees_document отвечает, увидит ли человек этот документ: false — упомянуть можно, но уведомление ему не уйдёт. Предмет не виден спрашивающему — 404. Ничего не пишет.

## Query parameters

- `subject_kind` 'flow_document' | 'payment_request', required
- `subject_id` string, uuid, required
- `q` string

## Headers

- `X-Tenant` string, required

## Response `200`

Кого можно упомянуть

- DocflowDocumentCommentCandidateList
  - `results` DocflowDocumentCommentCandidate[], required
    - `user_id` integer, required: Сотрудник кабинета
    - `name` string, required: Имя — так его пишут в тексте после «@»
    - `sees_document` boolean, required: Увидит ли документ; false — упоминание без уведомления

## Other responses

- `400`: Некорректный запрос или нарушение бизнес-правила
- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `404`: Запись не найдена или не видима текущему пользователю
- `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/mention-candidates/get.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)