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

# List mentionable users

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

## Request

- Base URL: `https://app.base44.com`
- URL: `https://app.base44.com/api/apps/{app_id}/comments/mentionable`
- Auth: HTTP bearer

<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.

The list is the same on every branch. `branch_id` only has to name a branch you can see, so you can call this with the `branch_id` you use for the comments themselves.

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.

## Query parameters

- `branch_id` string: ID of the branch to work on, as returned by [List branches](/api-reference/list-branches). Omit it to work on the app's main branch.

## 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, or no branch you can see has this `branch_id`.
- `409`: Your workspace requires an unlocked SSO session.
- `429`: Rate limit exceeded. Wait the number of seconds in `Retry-After` before retrying.

## Changes

- **2026-10-25** `835dda629ead`: 1 info
  - added the new optional `query` request parameter `branch_id`
- **2026-10-11** `80287813ab84`: 1 info
  - the endpoint scheme security `PersonalAccessTokenAuth` was added to the API
- **2026-10-07** `dddf17e0f9f0`: 1 info
  - endpoint added

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

---

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