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
Chatrow is created with a fixedcreatorplaceholder, 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.
OAuth 2.1 authorization code flow with PKCE (required of every client, public or confidential). Scopes are a ceiling on the credential, not a grant of access: a token also cannot exceed what the user who approved it may already do. A write scope does not imply its matching read — ask for both.
In: header
Scope: chat:read
Path Parameters
The unique identifier of the chat
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$uuidQuery Parameters
Optional partial name search filter (case-insensitive)
Sort order (1 for ascending, -1 for descending)
Default
{ "name": 1}Maximum number of results per page
value <= 10020Pagination type (cursor or index-based)
"index"Value in
- "cursor"
- "index"
Cursor for cursor-based pagination (only when paginate=cursor)
Reverse pagination direction (only when paginate=cursor)
falseInclude total counts (only when paginate=cursor)
falseInclude cursor record (only when paginate=cursor)
falsePage number (only when paginate=index)
1Response 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": "sha256", "contentSha256": "string", "originalName": "string", "originalExtension": "mov", "originalSizeInBytes": 0, "originalState": "stored", "processingCompletedAt": 0, "keepOriginal": true, "pruneAfter": 0, "pruneRequestedById": "106ef251-f0bc-45b7-8342-6f3d10dbd865", "pruneReason": "manual", "prunedAt": 0, "reattachStartedAt": 0, "reattachById": "250e32ee-9f86-4efa-94d3-2c18a10241d1", "reattachUploadId": "string", "pruneAttempts": 0, "pruneError": "string", "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 } ]}