Mentions

The people and brands a workspace mentions, each holding the handle it goes by on every network. A post body references a mention rather than a network handle, so the same mention resolves correctly on each network it is published to.

📄️List mentions

Returns a paginated collection of the workspace's mentions, most used first. Requires the ADMIN or MEMBER workspace role; the VIEWER role receives `403`.

📄️Create a mention

Creates a mention and the network identities it is known by. Requires the ADMIN or MEMBER workspace role; the VIEWER role receives `403`.

📄️Get a mention

Returns a single mention with its network identities. The response is a bare object (not wrapped in `data`). Requires the ADMIN or MEMBER workspace role; the VIEWER role receives `403`.

📄️Update a mention

Replaces the mention's name and its identities. The `identities` array is authoritative: a network left out of it has its identity removed, and the mention is then published as plain text on that network. Requires the ADMIN or MEMBER workspace role; the VIEWER role receives `403`.

📄️Delete a mention

Deletes the mention and every identity attached to it. Posts that reference it keep reading as written — the mention falls back to the plain text snapshot stored with it. Requires the ADMIN or MEMBER workspace role; the VIEWER role receives `403`.