Share Recording

Share a call read-only with one person in your account, or with everyone in it. Use it to send a colleague a call they cannot see on their own, for example a conflict call from your own automation.

• Read-only. The person can open the call page, play the audio and download the transcript. They cannot edit, delete or re-share it, and the call does not appear in their recordings list.
• Sign-in is always required. There are no public links. url in the response is the call’s normal page; it asks for sign-in and opens only for members of your account.
• Members only. email must belong to an active member of the account. Access ends as soon as you remove the share, or the person’s membership is locked or removed.
• One conversation. An internal call recorded on both lines is shared as one: either recording’s id works, and both list the same shares.

Path Parameters

Request Body

Send exactly one of email and everyone.

Request

curl -X POST "https://api.identitycall.ai/api/v1/public/recordings/018f3a00-0000-7000-8000-0000000000a1/shares" \
  -H "Authorization: Bearer $IDENTITYCALL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "ona@example.com", "message": "Conflict call, please review the end."}'

import os
import requests
 
API_KEY = os.environ.get("IDENTITYCALL_API_KEY")
recording_id = "018f3a00-0000-7000-8000-0000000000a1"
 
response = requests.post(
    f"https://api.identitycall.ai/api/v1/public/recordings/{recording_id}/shares",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={"email": "ona@example.com", "message": "Conflict call, please review the end."},
)
response.raise_for_status()
print(response.json()["data"]["url"])

Response

201 Created for a new share. Sharing again with someone who already has access returns 200 OK with the existing share and sends no email.

{
"data": {
  "id": 42,
  "everyone": false,
  "user": { "email": "ona@example.com", "name": "Ona Petraitienė" },
  "shared_by": { "type": "api_key", "name": "Your Company" },
  "created_at": "2026-10-03T09:12:44Z",
  "url": "https://app.identitycall.ai/recordings/018f3a00-0000-7000-8000-0000000000a1"
}
}

shared_by.name is the account name for a share made through the API, and the person’s name for one made in the app. shared_by.type becomes null once that user or API key is deleted.

List shares

curl "https://api.identitycall.ai/api/v1/public/recordings/018f3a00-0000-7000-8000-0000000000a1/shares" \
  -H "Authorization: Bearer $IDENTITYCALL_API_KEY"

Remove a share

curl -X DELETE "https://api.identitycall.ai/api/v1/public/recordings/018f3a00-0000-7000-8000-0000000000a1/shares/42" \
  -H "Authorization: Bearer $IDENTITYCALL_API_KEY"

Errors