> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.
# List mentionable users
> This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.
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.
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.
## OpenAPI
````yaml /developers/references/app-management/app-management-openapi.json get /api/apps/{app_id}/comments/mentionable
openapi: 3.1.0
info:
title: Base44 App Management API
version: 1.0.0
servers:
- url: https://app.base44.com
security:
- PersonalAccessTokenAuth: []
paths:
/api/apps/{app_id}/comments/mentionable:
get:
summary: List mentionable users
description: >-
This API is in beta. Endpoints, fields, and behavior may still
change, so avoid depending on it in production.
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.
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.
operationId: list_mentionable_users_api_apps__app_id__comments_mentionable_get
parameters:
- name: app_id
in: path
required: true
schema:
type: string
description: ID of the app.
title: App Id
description: ID of the app.
example: 6820f3a4e7b91d003c45a1f2
- name: branch_id
in: query
required: false
schema:
type: string
description: >-
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.
title: Branch Id
description: >-
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.
example: 68f1a2b3c4d5e6f708192a3b
responses:
'200':
description: The people a comment can mention, sorted by name.
content:
application/json:
schema:
$ref: '#/components/schemas/MentionableUsers'
'401':
description: Missing or invalid credentials.
'403':
description: >-
You don't have editor access to this app, the app is blocked, or you
used a workspace API key.
'404':
description: App not found, or no branch you can see has this `branch_id`.
'409':
description: Your workspace requires an unlocked SSO session.
'429':
description: >-
Rate limit exceeded. Wait the number of seconds in `Retry-After`
before retrying.
security:
- PersonalAccessTokenAuth:
- read_only
components:
schemas:
MentionableUsers:
items:
$ref: '#/components/schemas/MentionableUser'
type: array
title: MentionableUsers
description: The people a comment on the app can mention.
MentionableUser:
properties:
email:
type: string
title: Email
description: Email to pass in `mentioned_emails`.
example: dana@acme.com
name:
type: string
title: Name
description: Name of the person, or their email when they have no name.
example: Dana Levi
avatar_url:
anyOf:
- type: string
- type: 'null'
title: Avatar Url
description: URL of the person's profile image, or `null` when they have none.
example: https://lh3.googleusercontent.com/a/ACg8ocJ2
type: object
required:
- email
- name
title: MentionableUser
description: Someone a comment can mention.
securitySchemes:
PersonalAccessTokenAuth:
type: http
scheme: bearer
description: >-
Personal access token, sent as `Authorization: Bearer `. Each
operation lists the permission it needs: `read_only` or `full_access`. A
full-access token can call every operation. A read-only token can call
only the operations that list `read_only`; anything else returns 403
`read_only_credential_route_not_allowed`.
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.