Start a new convo
Start a new video or audio convo in a chat. If the chat already has an active convo it is auto-completed before the new one is created. Creates a Daily.co room and posts a system message in the chat. The starter automatically joins as an active participant and receives a meeting token. Gates (in order): convos feature flag (403 `featureDisabled`), active workspace subscription (400 `subscriptionNotActive`), the workspace `convos` capability (403 `capabilityNotAvailable`), a positive credit balance (400 `creditBalanceInsufficient`) and the same chat permission required to post a message in the chat (`canStartConvo`).
Start a new video or audio convo in a chat. If the chat already has an active convo it is auto-completed before the new one is created. Creates a Daily.co room and posts a system message in the chat. The starter automatically joins as an active participant and receives a meeting token.
Gates (in order): convos feature flag (403 featureDisabled), active workspace subscription
(400 subscriptionNotActive), the workspace convos capability (403 capabilityNotAvailable),
a positive credit balance (400 creditBalanceInsufficient) and the same chat permission required to post a message
in the chat (canStartConvo).
Authorization
bearerAuth In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
curl -X POST "https://example.com/convos" \ -H "Content-Type: application/json" \ -d '{ "chatId": "0190a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b", "chatType": "topic", "convoType": "video", "sendEmailNotification": false, "subject": "Design review" }'{ "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, "meetingToken": "string"}