---
title: "Mention Candidates"
method: GET
path: "/api/v1/comment-mention-candidates"
tags: ["comments"]
---

# Mention Candidates

`GET /api/v1/comment-mention-candidates`

Members of the caller's company, for the @-mention picker.

Not gated on a record: exposure equals `GET /companies/{id}/members`, which
every member can already call. A distinct literal path (no path params in
front of it), so it cannot be shadowed by `/comments/{comment_id}` or any
other parametrized route in this router.

## Query parameters

- `q` string, nullable
- `limit` integer

## Response `200`

Successful Response

- CommentMention[]
  - `user_id` string, uuid, required
  - `name` string — Falls back to the stored marker text.
  - `email` string

## Other responses

- `422` — Validation Error

## Changes

> 13 revisions in range; 1 not diffed.

- **2026-08-26** `53e8494489be` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/netter/apis/dmi-backend/changes/api/v1/comment-mention-candidates/get.md)

---

[API](https://skmtc.dev/netter/apis/dmi-backend.md) · [All operations](https://skmtc.dev/netter/apis/dmi-backend/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/netter/dmi-backend/revisions/23fc170642d3/schema)