Share conversation
Share a conversation with people by email or with a Channel, as Viewer or Collaborator.
POST https://cotlet.dev/api/v1/otter/conversations/{conversation_id}/share
write Confirm
Adds people or a Channel to a conversation's sharing list with the permission you choose. A Viewer can view and play back; a Collaborator can edit, export and add Takeaways. People who already have access are returned as already_shared and are not changed. If your workspace admin turned on Invite teammates to Workspace as free trial members, an address on the workspace domain also gets a workspace invite. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| conversation_id string required | string | Conversation ID from list_conversations or search_transcripts. |
| emails string[] | string[] | Email addresses to share with. Give emails, a channel_id or both. |
| channel_id string | string | Channel ID from list_channels. |
| permission enum | enum | viewer or collaborator. Default: viewer. |
Request
curl -X POST https://cotlet.dev/api/v1/otter/conversations/cv_7f3a91/share \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"emails":["dana@example.com","lee@example.com"],"permission":"viewer"}'result = client.call("otter", "share_conversation", {"conversation_id":"cv_7f3a91","emails":["dana@example.com","lee@example.com"],"permission":"viewer"})const result = await cotlet.call('otter', 'share_conversation', {"conversation_id":"cv_7f3a91","emails":["dana@example.com","lee@example.com"],"permission":"viewer"});cotlet call otter share_conversation --data '{"conversation_id":"cv_7f3a91","emails":["dana@example.com","lee@example.com"],"permission":"viewer"}'Example response
{
"conversation_id": "cv_7f3a91",
"shared_with": [
{
"email": "dana@example.com",
"permission": "viewer"
},
{
"email": "lee@example.com",
"permission": "viewer"
}
],
"already_shared": []
}