---
title: "List mentionable users"
method: GET
path: "/api/apps/{app_id}/comments/mentionable"
---

# List mentionable users

`GET /api/apps/{app_id}/comments/mentionable`

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Returns the people a comment on the app can mention: the app's owner and everyone who can edit it, sorted by name.

This is limited to 600 requests per minute per app, shared by [List comments](/api-reference/list-comments) and [List mentionable users](/api-reference/list-mentionable-users). A signed-in session has its own limit, and every personal access token for the workspace shares one. Some workspaces have a different limit. Every request that counts against the limit gets `X-RateLimit-Limit`, `X-RateLimit-Remaining` and `X-RateLimit-Reset` (Unix time in seconds) headers, and a `429` also gets `Retry-After` in seconds. If the limiter itself is unavailable, requests go through without these headers.

<Note>Call this as an editor of the app, with a personal access token sent as a Bearer token or from a signed-in session. A read-only token works here. Workspace API keys aren't accepted.</Note>

## Path parameters

- `app_id` string, required — ID of the app.

## Response `200`

The people a comment can mention, sorted by name.

- MentionableUser[] — The people a comment on the app can mention.
  - `email` string, required — Email to pass in `mentioned_emails`.
  - `name` string, required — Name of the person, or their email when they have no name.
  - `avatar_url` string, nullable — URL of the person's profile image, or `null` when they have none.

## Other responses

- `401` — Missing or invalid credentials.
- `403` — You don't have editor access to this app, the app is blocked, or you used a workspace API key.
- `404` — App not found.
- `409` — Your workspace requires an unlocked SSO session.
- `429` — Rate limit exceeded. Wait the number of seconds in `Retry-After` before retrying.

## Changes

> 28 revisions in range; 1 not diffed.

- **2026-10-06** `dddf17e0f9f0` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/adexad/apis/base44-app-management-api/changes/api/apps/:app_id/comments/mentionable/get.md)

---

[API](https://skmtc.dev/adexad/apis/base44-app-management-api.md) · [All operations](https://skmtc.dev/adexad/apis/base44-app-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/adexad/apis/base44-app-management-api/revisions/99df85f579f9?raw)
