Unshare conversation

Remove a person or a Channel from the sharing list of a conversation.

POST https://cotlet.dev/api/v1/otter/conversations/{conversation_id}/unshare

write Confirm

Removes one person or one Channel from a conversation's sharing list, the same as Remove in the Share dialog. They lose access at once. You can share again at any time with share_conversation. Public link settings are not changed. By default you confirm each call; you can switch that off for this tool.

Parameters

Parameters: unshare_conversation
NameTypeDescription
conversation_id string required string Conversation ID from list_conversations or search_transcripts.
email string string Person to remove. Give an email or a channel_id.
channel_id string string Channel to remove.

Request

cURL
curl -X POST https://cotlet.dev/api/v1/otter/conversations/conversation_8c41d2/unshare \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("otter", "unshare_conversation", {"conversation_id":"conversation_8c41d2"})
Node.js
const result = await cotlet.call('otter', 'unshare_conversation', {"conversation_id":"conversation_8c41d2"});
CLI
cotlet call otter unshare_conversation --data '{"conversation_id":"conversation_8c41d2"}'

Example response

JSON

{
  "conversation_id": "cv_7f3a91",
  "removed": "lee@example.com",
  "shared_with": [
    {
      "email": "dana@example.com",
      "permission": "viewer"
    }
  ]
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.