Clarify API
Meeting Recordings

Get recording artifacts

Returns short-lived signed URLs for a recording’s video and transcript files. Either URL is `null` when that artifact is not available.

POST
/workspaces/{workspace}/meetings/{meetingId}/recordings/{id}/artifacts

Authorization

apiKey
Authorization<token>

API key authentication. Send your key in the Authorization header as: api-key <your-api-key>.

In: header

Path Parameters

workspace*string

The workspace slug — the {slug} segment of your Clarify workspace URL.

meetingId*string

The unique ID of the meeting.

id*string

The unique ID of the recording.

Query Parameters

silent?boolean

When true, suppresses in-app and Slack notifications for this mutation.

Response Body

application/json

curl -X POST "https://example.com/workspaces/string/meetings/string/recordings/string/artifacts"
{
  "data": {
    "videoUrl": "https://storage.clarify.ai/recordings/acme/2f7a9c1e-4b6d-4e8a-9c0f-1d3b5e7a9c62/video.mp4?signature=...",
    "transcriptionUrl": "https://storage.clarify.ai/recordings/acme/2f7a9c1e-4b6d-4e8a-9c0f-1d3b5e7a9c62/transcript.json?signature=..."
  }
}

Enable meeting recording

Turns on recording for a meeting so a notetaker bot joins the call. Returns the updated meeting record.

Start a recording media upload

Creates a pending recording on the meeting and returns a presigned S3 POST policy for uploading an audio or video file directly to storage. Uploaded media is stored for playback and is not transcribed. Optionally include a transcript in the same request so one recording carries both video and transcript. Submit the file to the returned policy, then confirm the upload. Pass `recordingId` to overwrite a completed manual-upload recording instead of creating a new one.