Convos
Get all convos for a chat
Retrieve all convos (active, completed, or cancelled) for a specific chat. Results are sorted by creation time in descending order (newest first). Optionally filter by status. Requires read access to the chat (`canGetChat`) and an active workspace subscription.
Retrieve all convos (active, completed, or cancelled) for a specific chat.
Results are sorted by creation time in descending order (newest first).
Optionally filter by status. Requires read access to the chat (canGetChat) and an active workspace subscription.
Authorization
bearerAuth AuthorizationBearer <token>
In: header
Path Parameters
chatId*string
Chat ID
Format
uuidQuery Parameters
status?string
Filter convos by status
Value in
- "active"
- "completed"
- "cancelled"
Response Body
application/json
curl -X GET "https://example.com/chats/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 }]