---
title: "List Mentionable Profiles"
method: GET
path: "/v2/profiles/mentionable"
tags: ["v2 - Profiles"]
---

# List Mentionable Profiles

`GET /v2/profiles/mentionable`

## Request

- Base URL: `https://api.jubjubapp.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.jubjubapp.com/v2/profiles/mentionable`
- Auth: HTTP bearer

Return profiles matching `prefix` for @mention autocomplete.

Ranking:
  1. `workspace_member` — the workspace's people: owner, direct members,
     the members of the team the workspace is linked to (`team_id`), and
     the caller. The same union as GET /v2/workspaces/{id}/members; a
     team member has access to the workspace, so they are a person in
     it (2026-09-09: a confirmed team member could not be tagged from a
     workspace their team owns). Matched on handle, display name OR
     email, so a member with no handle is found by name and a member
     with no name yet is found by email. With an empty prefix this is
     the whole list, which is what a bare "@" shows. Sorted by
     handle/name.
  2. `recent_collaborator` — profiles whose handle starts with `prefix`
     and who share a workspace with the caller where activity occurred
     within the last 90 days. Sorted by `last_collaborated_at` desc,
     then alphabetical by handle. Skipped for an empty prefix.

The caller is included. A solo workspace has exactly one person in it,
and that person could not tag themself (2026-09-05: "No matching
profiles" on the owner's own workspace).

Recency gate ("90-day window"): if no shared workspace has any activity
(content, launch, or workspace-scope comment) within the last 90 days,
the candidate is dropped. v0 simplification documented in
`_latest_workspace_activity`.

## Query parameters

- `prefix` string: Handle or name prefix, case-insensitive. Empty lists the workspace's people.
- `workspace_id` string, nullable: Optional workspace_id to boost direct members
- `limit` integer: Maximum results (capped at 25)

## Headers

- `Authorization` string
- `X-JubJub-Service-Key` string
- `X-JubJub-Agent-Key` string
- `X-JubJub-Platform-Key` string
- `Origin` string
- `Referer` string
- `X-JubJub-Trial-Token` string

## Response `200`

Successful Response

- MentionableListResponse
  - `profiles` MentionableProfile[], required
    - `member_ref` string, nullable
    - `handle` string, nullable
    - `display_name` string, nullable
    - `avatar_url` string, nullable
    - `email` string, nullable
    - `source` 'workspace_member' | 'recent_collaborator', required
    - `last_collaborated_at` string, date-time, nullable: Most recent activity timestamp in a shared workspace (null for workspace_member source)

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/jubjubapp/apis/jubjub-api.md) - [All operations](https://skmtc.dev/jubjubapp/apis/jubjub-api/llms.txt) - [OpenAPI document](https://skmtc.dev/jubjubapp/apis/jubjub-api/revisions/353157b296f2?raw)