---
title: "Parse mentions in markdown text"
method: POST
path: "/api/v1/w/{wId}/assistant/mentions/parse"
tags: ["Mentions"]
---

# Parse mentions in markdown text

`POST /api/v1/w/{wId}/assistant/mentions/parse`

Parses pasted text containing @ mentions and converts them to the proper mention format.
Matches @agentName or @userName patterns against available agents and users.

## Path parameters

- `wId` string, required

## Request body

- object
  - `markdown` string, required — Markdown text containing @ mentions to parse

## Response `200`

Parsed markdown with mentions converted to proper format

- object
  - `markdown` string — Processed markdown text with mentions converted to serialized format

## Other responses

- `400` — Bad Request. Missing or invalid request body.
- `401` — Unauthorized. Invalid or missing authentication token.
- `500` — Internal Server Error.

---

[API](https://skmtc.net/dust-tt/apis/dust-api-documentation.md) · [All operations](https://skmtc.net/dust-tt/apis/dust-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dust-tt/dust-api-documentation/revisions/41617009c89a/schema)