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. Optionally include a transcript in the same request so one recording carries both video and transcript, or set transcribe to have Clarify transcribe the media in the background after confirmation. 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. A workspace API key can upload to any meeting and overwrite any completed manual-upload recording.

Authorization

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.

Query Parameters

silent?boolean

When true, suppresses in-app and Slack notifications for this mutation and batches its live updates, so open views can lag by up to 20 seconds.

Header Parameters

clarify-version?string

The API version for this request. Send 2026-11 to get the behavior documented here. Omit it to use your API key's version, which this header can raise but not lower.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

recordingId?string

A completed manual-upload recording to overwrite. When omitted, a new recording is created on the meeting. Only the artifacts supplied in this request are overwritten; other stored artifacts are left intact.

Formatuuid

contentType*string

The MIME type of the media file to upload; must be an audio/* or video/* type. Uploaded media is stored for playback, and is transcribed only when transcribe is true.

Match^(audio|video)\/

transcript?array<>

An optional transcript to attach to the same recording as the media, so one recording carries both. Applied to the recording when the upload is confirmed, then used to generate the summary. Also accepts the Recall.ai 1.11 format (participant plus words[].start_timestamp.relative), which is converted to the segment shape.

transcribe?boolean

Whether Clarify transcribes the uploaded media with speaker labels after the upload is confirmed, then generates the meeting summary from it. Defaults to false. Cannot be combined with transcript. Transcription runs in the background, and the recording stays playable if it fails.

Response Body

`application/json`

curl -X POST "https://example.com/workspaces/string/meetings/string/recordings/media" \  -H "clarify-version: 2026-11" \  -H "Content-Type: application/json" \  -d '{    "contentType": "video/mp4"  }'

{  "data": {    "recordingId": "2f7a9c1e-4b6d-4e8a-9c0f-1d3b5e7a9c62",    "meetingId": "6c8e0a2b-4d5f-4a7b-9c1d-3e5f7a9b1c2d",    "key": "acme/manual/2026-02-01/2f7a9c1e-4b6d-4e8a-9c0f-1d3b5e7a9c62/recording-7e71a013-1341-4472-a54d-63d81a56b5dd.mp4",    "upload": {      "url": "https://storage.clarify.ai/meeting-recordings",      "fields": {        "key": "acme/manual/2026-02-01/2f7a9c1e-4b6d-4e8a-9c0f-1d3b5e7a9c62/recording-7e71a013-1341-4472-a54d-63d81a56b5dd.mp4",        "Content-Type": "video/mp4",        "policy": "...",        "x-amz-signature": "..."      }    }  }}