---
title: "List mentions comment threads"
method: GET
path: "/api/v1/collaboration/comment-threads/list-mentions"
tags: ["collaboration"]
---

# List mentions comment threads

`GET /api/v1/collaboration/comment-threads/list-mentions`

## Request

- Base URL: `https://point11.ai`
- URL: `https://point11.ai/api/v1/collaboration/comment-threads/list-mentions`
- Auth: OAuth 2 (authorization code, authorization URL `https://auth.point11.ai/oauth2/authorize`, token URL `https://auth.point11.ai/oauth2/token`)

List the comments that mention the signed-in member, newest first: each comment's author, text and time, the thread it is in (its page, anchor, status, and whether it is unread for the member), and the name of the campaign the thread is about when its product knows one. Deleted comments and threads are left out. Needs a signed-in user: mentions are per member, so API keys are refused.

## Query parameters

- `limit` integer: Number of items to return (1–1000)
- `cursor` string: Opaque cursor returned as nextCursor by the previous page

## Headers

- `Point11-Organization` string, uuid

## Response `200`

Success.

- CollaborationCommentThreadsListMentionsResponse
  - `data` object[], required
    - `commentId` string, required
    - `body` string, required: The comment's text
    - `createdAt` string, date-time, required
    - `author` object, required
      - `id` string, required
      - `name` string, nullable, required
      - `email` string, required
      - `imageUrl` string, nullable, required
    - `thread` object, required
      - `id` string, required
      - `surfaceId` string, required
      - `artifactId` string, required
      - `canonicalHref` string, required: The dashboard path the thread was left on
      - `anchor` union, required
        - object
          - `kind` 'metric_card', required
          - `key` string, required
          - `label` string, required
        - object
          - `kind` 'table_card', required
          - `key` string, required
          - `label` string, required
        - object
          - `kind` 'report_section', required
          - `key` string, required
          - `label` string, required
        - object
          - `kind` 'replay', required
          - `key` 'replay', required
          - `label` string, required
      - `status` 'open' | 'resolved', required
      - `unread` boolean, required: Whether the thread changed since the caller last read it
    - `campaignName` string, nullable, required: The campaign the thread is about; null when it has no name or no longer exists
  - `nextCursor` string, nullable, required

## Other responses

- `400`: The input, query, or Idempotency-Key is invalid.
- `401`: The bearer is missing, expired, or not accepted.
- `403`: The credential lacks the operation's scope or role, or the operation needs a different door.
- `404`: The resource or organization does not exist for this caller.
- `405`: This path takes another HTTP method, named in `Allow`.
- `409`: The request conflicts with current state or with prior use of its Idempotency-Key.
- `413`: The request, or the answer it asks for, is too large; narrow it.
- `429`: The credential's rate budget is spent; retry after `Retry-After` seconds.
- `500`: An unexpected server failure; retry later. Only `request_id` identifies it.
- `503`: A dependency is temporarily unavailable; retry after `Retry-After` seconds.
- `default`: Another status a product answers for its own refusal (for example `415` for an unsupported attachment); branch on `code`.

---

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