---
title: "Get mention suggestions"
method: GET
path: "/api/v1/w/{wId}/assistant/mentions/suggestions"
tags: ["Mentions"]
---

# Get mention suggestions

`GET /api/v1/w/{wId}/assistant/mentions/suggestions`

## Request

- Base URL: `https://dust.tt`
- URL: `https://dust.tt/api/v1/w/{wId}/assistant/mentions/suggestions`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/dust-tt/apis/dust-api-documentation/docs/api/v1/w/:wId/assistant/mentions/suggestions/get.ts> (a function with typed inputs; its response is checked against the schema)

Get suggestions for mentions (agents and users) based on a query string.

## Path parameters

- `wId` string, required

## Query parameters

- `query` string, required
- `select` string[]
- `current` boolean

## Response `200`

List of mention suggestions

- object
  - `suggestions` RichMention[]
    - `id` string, required: Unique identifier for the mention (agent sId or user sId)
    - `type` 'agent' | 'user', required: Type of the mention
    - `label` string, required: Display label for the mention
    - `pictureUrl` string, required: URL of the profile picture
    - `description` string, required: Description of the mention (agent description or user email)
    - `userFavorite` boolean, nullable: Whether the agent is marked as a favorite by the user (only for agent mentions)

## Other responses

- `400`: Bad Request. Missing or invalid parameters.
- `401`: Unauthorized. Invalid or missing authentication token.
- `500`: Internal Server Error.

---

[API](https://skmtc.dev/dust-tt/apis/dust-api-documentation.md) - [All operations](https://skmtc.dev/dust-tt/apis/dust-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/dust-tt/apis/dust-api-documentation/revisions/abb1c0993938?raw)