Share a call
Share a call with a person by email at the access level you choose.
POST https://cotlet.dev/api/v1/fathom-video/calls/{call_id}/share
write Confirm
Adds one email address to the Share menu of the call at limited, standard or admin access, as in the Share dialog. Limited sees the transcript, summary and recording; standard also downloads the call and sees highlights and action items; admin also shares the link, trims the recording and edits the transcript. You need a role that allows sharing the call. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| call_id string required | string | Call ID from list_calls: the number in the call address, fathom.video/calls/{call_id}. |
| email string required | string | Email address of the person to share with. |
| access enum required | enum | limited, standard or admin. |
Request
curl -X POST https://cotlet.dev/api/v1/fathom-video/calls/610313346/share \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"email":"marc@example.com","access":"standard"}'result = client.call("fathom-video", "share_call", {"call_id":"610313346","email":"marc@example.com","access":"standard"})const result = await cotlet.call('fathom-video', 'share_call', {"call_id":"610313346","email":"marc@example.com","access":"standard"});cotlet call fathom-video share_call --data '{"call_id":"610313346","email":"marc@example.com","access":"standard"}'Example response
{
"call_id": "610313346",
"email": "marc@example.com",
"access": "standard",
"status": "shared"
}