Nurama Developers
Chats

Get every project topic chat the user can access in a workspace

Returns the creator/reviewer project topic chats across all projects in the workspace that the caller can read, with the latest message and message count for each. Access is derived per project from the caller's inherited permissions (`canGetCreatorChat` / `canGetReviewerChat`). Requires `canGetWorkspace` on the workspace. Results are ordered by most recent activity.

GET
/chats/workspace/{workspaceId}/project-chats

Returns the creator/reviewer project topic chats across all projects in the workspace that the caller can read, with the latest message and message count for each. Access is derived per project from the caller's inherited permissions (canGetCreatorChat / canGetReviewerChat). Requires canGetWorkspace on the workspace. Results are ordered by most recent activity.

Authorization

AuthorizationBearer <token>

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

workspaceId*string

The unique identifier of the workspace

Match^[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}$
Formatuuid

Response Body

application/json

curl -X GET "https://example.com/chats/workspace/497f6eca-6276-4993-bfeb-53cbbbba6f08/project-chats"
[  {    "project": {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "name": "string",      "logo": {        "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      },      "color": "string"    },    "visibility": "creator",    "chat": {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "topicType": "project",      "topicId": "97b608a9-302e-4387-a5f4-fd35969cdc21",      "visibility": "creator",      "participants": [        "e3139958-26f5-4fd4-a9c9-fe1c29c5cbac"      ],      "totalMessages": 0,      "recentMessages": [        {          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",          "type": "user",          "dataType": "notification",          "dataId": "5647597e-5960-4cd9-8287-791d36aa4685",          "data": "808ac6e4-93ed-4040-85a5-6c71a2444e90",          "chatId": "f255124e-3419-4f6e-b7ee-17a6577db94d",          "chatType": "topic",          "authorId": "ee6f7132-bd0a-4fcd-83b3-a8022377067b",          "author": {            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",            "firstName": "string",            "lastName": "string",            "displayName": "string",            "avatar": "01d8bd6c-6014-46aa-b5b1-14d337c9c779",            "color": "string",            "awards": [              "staff"            ],            "accountType": "standard"          },          "guestId": "db7efe8f-f9c5-48b1-ba1e-30c39617b97d",          "guestName": "string",          "guestColor": "string",          "replyToId": null,          "content": "string",          "mentions": [            "777c52f7-3433-49cb-b0a3-cd6473c2c951"          ],          "assetMentions": [            "33c9f99d-d0e6-413a-8a20-2b070ddbb3e6"          ],          "folderMentions": [            "16b8140a-38c5-4330-83d5-bd6117a3e481"          ],          "submissionMentions": [            "dfb873dd-628b-446d-a7b3-aef774c3c50a"          ],          "publicMentions": [            "string"          ],          "taskMentions": [            "bb41b8dc-c355-4766-acc1-55693c83896e"          ],          "taskCards": [            "e3196039-692a-4ea1-be8d-6850035a72f9"          ],          "suggestedTasks": [            {              "subject": "string",              "description": "string",              "assignedToId": "7a15e53b-1403-4928-9451-d7062c3a8737",              "boardId": "a654038e-9287-48a2-acfd-90b8cfa8b1f4",              "columnId": "b0676e1a-d8a0-4c5f-99e7-a0ee8909f6dd"            }          ],          "quotes": [            "ea3b6941-45f7-4e0a-8d2b-6582d4d35a68"          ],          "attachments": [            "9904dd49-22c6-4edb-be09-aa27b9abd8f3"          ],          "revisions": [            {}          ],          "meta": {},          "status": "active",          "totalReplies": 0,          "recentReplies": [            "45984f84-2e0e-475b-b8a5-e4cfa03139f5"          ],          "annotations": [            {              "color": "#9b9b9b",              "frame": 0,              "timestamp": 0,              "startTimestamp": 0,              "endTimestamp": 0,              "left": 0,              "top": 0,              "width": 0.1,              "height": 0.1,              "scaleX": 1,              "scaleY": 1,              "angle": 0,              "skewX": 0,              "skewY": 0,              "flipX": false,              "flipY": false,              "originX": "left",              "originY": "top",              "opacity": 1,              "visible": true,              "shadow": {                "color": "rgba(0,0,0,0.3)",                "blur": 5,                "offsetX": 0.2,                "offsetY": 0.2              },              "strokeLineCap": "butt",              "strokeLineJoin": "miter",              "strokeMiterLimit": 4,              "strokeDashArray": [                0.1              ],              "fillRule": "nonzero",              "nestedAnnotations": [                {                  "type": "dot",                  "coordinates": {                    "x": 0,                    "y": 0                  },                  "radius": 10                }              ],              "type": "dot",              "coordinates": {                "x": 0,                "y": 0              },              "radius": 10            }          ],          "linkPreviews": [            {              "url": "http://example.com",              "title": "string",              "description": "string",              "image": "http://example.com",              "siteName": "string",              "favicon": "http://example.com",              "signature": "string"            }          ],          "reactions": [            {              "user": "76f62a58-5404-486d-9afc-07bded328704",              "emoji": "👍"            }          ],          "highlighted": false,          "highlightedById": "2ed80d19-af19-4b14-bdad-240edd29da18",          "highlightedAt": 0,          "isConvoMessage": false,          "scopeId": "65fafe40-a220-4dd7-8724-4598b81c0643",          "scopeType": "project",          "scopeVisibility": [            "creator"          ],          "inheritanceId": "09c886ac-e6e5-4263-a494-a6e14f7e4f46",          "aiRole": "assistant",          "aiModel": "string",          "aiTokensIn": 0,          "aiTokensOut": 0,          "aiToolCalls": [            {}          ],          "aiToolResults": [            {}          ],          "aiUsageEventId": "f5c2aaa2-8335-4359-b76a-d9a02c9cdabb",          "createdAt": 1678886400000,          "updatedAt": 1678886400000        }      ],      "createdAt": 0,      "updatedAt": 0    }  }]