Get mentionable assets for a chat with pagination

Returns a paginated list of assets that can be mentioned in the specified chat. The assets returned depend on the chat type: - **Topic chat about a project**: Returns assets from that project with matching visibility - **Topic chat about an asset**: Returns assets from the asset's owner project with matching visibility - **Member chat with project scope**: Returns all assets from that project (all visibilities) - **Submission chat**: Returns all assets from the project (all visibilities) - **AI chat (Nu Chat)**: Returns assets from the topic's project, filtered to the **caller's own** visibility tiers. A workspace- or social-scoped topic has no project to resolve against and returns an empty array. Unlike every other chat type above, an AI chat has no meaningful visibility of its own to inherit — its backing `Chat` row is created with a fixed `creator` placeholder, identical for every user — so tiers are derived from the caller's inherited permissions instead. Owning the topic is not on its own evidence of creator-tier access to the project. - **Member chat with workspace/social scope**: Returns empty array (no assets are mentionable) Only active assets are returned. Supports both cursor-based and index-based pagination, plus name filtering.

Returns a paginated list of assets that can be mentioned in the specified chat. The assets returned depend on the chat type:

Topic chat about a project: Returns assets from that project with matching visibility
Topic chat about an asset: Returns assets from the asset's owner project with matching visibility
Member chat with project scope: Returns all assets from that project (all visibilities)
Submission chat: Returns all assets from the project (all visibilities)
AI chat (Nu Chat): Returns assets from the topic's project, filtered to the caller's own visibility tiers. A workspace- or social-scoped topic has no project to resolve against and returns an empty array.

Unlike every other chat type above, an AI chat has no meaningful visibility of its own to inherit — its backing Chat row is created with a fixed creator placeholder, identical for every user — so tiers are derived from the caller's inherited permissions instead. Owning the topic is not on its own evidence of creator-tier access to the project.
Member chat with workspace/social scope: Returns empty array (no assets are mentionable)

Only active assets are returned. Supports both cursor-based and index-based pagination, plus name filtering.

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Path Parameters

chatId*string

The unique identifier of the chat

Formatuuid

Query Parameters

nameSearch?string

Optional partial name search filter (case-insensitive)

sort?

Sort order (1 for ascending, -1 for descending)

Default

{  "name": 1}

limit?number

Maximum number of results per page

Rangevalue <= 100

Default20

paginate?string

Pagination type (cursor or index-based)

Default"index"

Value in

"cursor"
"index"

cursor?string

Cursor for cursor-based pagination (only when paginate=cursor)

paginateReverse?boolean

Reverse pagination direction (only when paginate=cursor)

includeCounts?boolean

Include total counts (only when paginate=cursor)

includeCursorRecord?boolean

Include cursor record (only when paginate=cursor)

page?number

Page number (only when paginate=index)

Response Body

`application/json`

curl -X GET "https://example.com/chats/497f6eca-6276-4993-bfeb-53cbbbba6f08/mentionable/assets"

{  "page": 0,  "limit": 0,  "totalPages": 0,  "totalResults": 0,  "queryAt": 0,  "results": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "ownerResourceId": "7d5ad1db-89f9-42df-868c-86a72347ae1c",      "ownerResourceType": "workspace",      "creatorId": "688ebf54-d343-4104-8711-82c2feac534a",      "creator": {        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "firstName": "string",        "lastName": "string",        "displayName": "string",        "avatar": "01d8bd6c-6014-46aa-b5b1-14d337c9c779",        "color": "string",        "awards": [          "staff"        ],        "accountType": "standard"      },      "fileSystemPaths": [        "string"      ],      "basePath": "string",      "noFileSystem": false,      "keyPath": "string",      "checksum": "string",      "checksumAlgorithm": "md5",      "name": "string",      "slug": "string",      "functionType": "attachment",      "mediaType": "image",      "tags": [],      "files": [        {          "assetId": "9179b887-04ef-4ce5-ab3a-b5bbd39ea3c8",          "keyPath": "/project/asset/file123.jpg",          "checksum": "string",          "checksumAlgorithm": "md5",          "name": "string",          "functionType": "original",          "sizeInBytes": 0,          "status": "active",          "meta": {},          "createdAt": 1678886400000,          "updatedAt": 1678886400000        }      ],      "chats": {        "creatorLastMessageAt": "2019-08-24T14:15:22Z",        "reviewerLastMessageAt": "2019-08-24T14:15:22Z",        "creator": "1dccd4a6-75d2-43aa-a088-76d941f1b60a",        "reviewer": "a4b7b7a3-a1d0-4e27-9161-fa5679d1e0d6"      },      "expectedUploadSizeInMB": 0,      "sizeInBytes": 0,      "visibility": [        "creator"      ],      "publishedOn": 1678886400000,      "publisherId": "f1ba8124-cabe-46cd-b4f9-1189594ff7b3",      "publisher": {        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "firstName": "string",        "lastName": "string",        "displayName": "string",        "avatar": "01d8bd6c-6014-46aa-b5b1-14d337c9c779",        "color": "string",        "awards": [          "staff"        ],        "accountType": "standard"      },      "hasActivePublicLink": false,      "hasActivePublicFileSystem": false,      "everPublic": false,      "publicFileSystemIds": [        "3a3392f6-5ad7-429c-8b57-759911bd1423"      ],      "publicAssetLinkIds": [        "35788e46-f1b0-471c-b8ec-69afab5a9e64"      ],      "submissionFileSystemIds": [        "c658ae43-33f0-4032-85f0-ea3242de6509"      ],      "aiGenerated": false,      "promotedFromAssetId": "c833ed16-de04-406f-a750-9ed1e24820b3",      "contentSnippet": "string",      "status": "active",      "meta": {},      "inheritanceId": "09c886ac-e6e5-4263-a494-a6e14f7e4f46",      "inheritance": {        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "resourceId": "026d60bb-63a8-407e-bf67-01dcfc6022e6",        "resourceType": "string",        "inheritance": {          "0192a3b4-5c6d-7e8f-9a0b-1c2d3e4f5a6b": "workspace",          "0192a3b4-5c6d-7e8f-9a0b-1c2d3e4f5a6c": "project"        },        "inheritanceInverted": {          "property1": "497f6eca-6276-4993-bfeb-53cbbbba6f08",          "property2": "497f6eca-6276-4993-bfeb-53cbbbba6f08"        },        "path": "string",        "createdAt": "2019-08-24T14:15:22Z",        "updatedAt": "2019-08-24T14:15:22Z"      },      "createdAt": 1678886400000,      "updatedAt": 1678886400000    }  ]}