Join an active convo
Join an active convo. User must have access to the chat and the convo must be in active status. Returns a Daily.co meeting token for the user to join the room. User is added to both activeParticipants and allParticipants arrays. **Cross-device handover:** If the user is already an active participant (e.g. joining from a second device), the join still succeeds and returns a new meeting token. A `convoHandover` WebSocket notification is sent to the user's personal channel (`user/{userId}`) so the old device can close its convo window. The user is not duplicated in activeParticipants.
Join an active convo. User must have access to the chat and the convo must be in active status. Returns a Daily.co meeting token for the user to join the room. User is added to both activeParticipants and allParticipants arrays.
Cross-device handover: If the user is already an active participant (e.g. joining from a second device),
the join still succeeds and returns a new meeting token. A convoHandover WebSocket notification is sent
to the user's personal channel (user/{userId}) so the old device can close its convo window.
The user is not duplicated in activeParticipants.
Authorization
bearerAuth In: header
Path Parameters
Convo ID
uuidResponse Body
application/json
curl -X PUT "https://example.com/convos/497f6eca-6276-4993-bfeb-53cbbbba6f08/join"{ "convo": { "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 }, "token": "string"}