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

> ## Agent Instructions
> Internal links on these pages omit the .md extension. Append .md to a docs page URL, or send an Accept: text/markdown header, to get that page as markdown.

# List mentionable users

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



## 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: >-
        <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>
      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
      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.
        '409':
          description: Your workspace requires an unlocked SSO session.
        '429':
          description: >-
            Rate limit exceeded. Wait the number of seconds in `Retry-After`
            before retrying.
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 <token>`.'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.