---
title: "Email the teammates a comment just @-mentioned (docs/specs/012-collaboration/comment-mentions.md). The document must be in this team's library; each mention must be a member of the team. Best-effort; a recipient may have opted out."
method: POST
path: "/teams/{id}/notify-mention"
tags: ["Teams"]
---

# Email the teammates a comment just @-mentioned (docs/specs/012-collaboration/comment-mentions.md). The document must be in this team's library; each mention must be a member of the team. Best-effort; a recipient may have opted out.

`POST /teams/{id}/notify-mention`

## Request

- Base URL: `https://www.livediagram.app/api`
- URL: `https://www.livediagram.app/api/teams/{id}/notify-mention`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Request body

- object
  - `documentId` string, required
  - `commentText` string, required
  - `mentions` object[], required
    - `userId` string
    - `memberId` string
  - `itemId` string

## Response `202`

Success.

## Other responses

- `400`: Error.
- `401`: Error.
- `403`: Error.
- `404`: Error.
- `429`: Rate limited. Back off and retry.

---

[API](https://skmtc.dev/livediagram/apis/livediagram-api.md) · [All operations](https://skmtc.dev/livediagram/apis/livediagram-api/llms.txt) · [OpenAPI document](https://skmtc.dev/livediagram/apis/livediagram-api/revisions/f286d27acfd2?raw)