Get all convos for a project (Convos drawer)
Retrieve all convos across all chats within a project. Results are sorted by creation time in descending order (newest first). Optionally filter by visibility (creator/reviewer) and status. This endpoint is used for the "Convos drawer" feature to show all project convos in one place. Requires `canGetProject` and an active workspace subscription.
Retrieve all convos across all chats within a project.
Results are sorted by creation time in descending order (newest first).
Optionally filter by visibility (creator/reviewer) and status.
This endpoint is used for the "Convos drawer" feature to show all project convos in one place.
Requires canGetProject and an active workspace subscription.
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: projects:read
Path Parameters
Project ID
^[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
Filter convos by chat visibility (creator or reviewer chats)
Value in
- "creator"
- "reviewer"
Filter convos by status
Value in
- "active"
- "completed"
- "cancelled"
Response Body
application/json
curl -X GET "https://example.com/projects/497f6eca-6276-4993-bfeb-53cbbbba6f08/convos"[ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "convoType": "video", "status": "active", "subject": "string", "notes": "string", "chatId": "f255124e-3419-4f6e-b7ee-17a6577db94d", "chat": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "chatType": "topic", "topicId": "97b608a9-302e-4387-a5f4-fd35969cdc21", "topicType": "asset", "replyType": "quote", "subject": "string", "visibility": "creator", "publicId": "f72dfe8e-6cfd-43c2-b1cb-95adbf313789", "participants": [ "e3139958-26f5-4fd4-a9c9-fe1c29c5cbac" ], "following": [ "6bc36f94-42f8-4778-8086-0f778a9e5f30" ], "annotations": [ {} ], "totalMessages": 0, "lastMessageAt": "2019-08-24T14:15:22Z", "recentMessages": [ "6738c803-41a8-4296-a5bd-8d9974ec6fa0" ], "activeConvoId": "6ac5e0e4-f5db-4276-ac1c-9dd077ad79d2", "activeConvo": "d97b3779-3421-4076-bf6e-15252c014d1d", "status": "active", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z" }, "chatType": "chat", "messageId": "8540d774-4863-4d2b-b788-4ecb19412e85", "message": "3eb7c4fd-0d67-442a-a08d-929546df1ebe", "dailyRoomName": "string", "dailyRoomUrl": "string", "dailyRoomConfig": {}, "startedById": "7347b630-d3cd-4c11-b046-3f92c23756e5", "startedBy": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "firstName": "string", "lastName": "string", "displayName": "string", "avatar": "01d8bd6c-6014-46aa-b5b1-14d337c9c779", "color": "string", "awards": [ "staff" ], "accountType": "standard" }, "activeParticipants": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "firstName": "string", "lastName": "string", "displayName": "string", "avatar": "01d8bd6c-6014-46aa-b5b1-14d337c9c779", "color": "string", "awards": [ "staff" ], "accountType": "standard" } ], "allParticipants": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "firstName": "string", "lastName": "string", "displayName": "string", "avatar": "01d8bd6c-6014-46aa-b5b1-14d337c9c779", "color": "string", "awards": [ "staff" ], "accountType": "standard" } ], "startedAt": 0, "endedAt": 0, "durationMinutes": 0, "recordings": [ {} ], "transcripts": [ {} ], "participantSessions": [ {} ], "billedAtVideo": 0, "billedCreditsVideo": 0, "billedAtRecording": 0, "billedCreditsRecording": 0, "inheritanceId": "09c886ac-e6e5-4263-a494-a6e14f7e4f46", "scopeId": "65fafe40-a220-4dd7-8724-4598b81c0643", "scopeType": "project", "scopeVisibility": [ "creator" ], "createdAt": 0, "updatedAt": 0 }]