Clarify APIUpload a recording transcript
Creates a recording on the meeting from an externally captured transcript, so meetings recorded outside Clarify can be summarized and searched, and triggers summary generation. A meeting with a recording already gets a second recording. Pass `recordingId` to overwrite a completed manual-upload recording’s transcript instead. Returns the recording.
Authorization
apiKey API key authentication. Send your key in the Authorization header as: api-key <your-api-key>.
In: header
Path Parameters
The workspace slug — the {slug} segment of your Clarify workspace URL.
The unique ID of the meeting.
Query Parameters
When true, suppresses in-app and Slack notifications for this mutation.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
curl -X POST "https://example.com/workspaces/string/meetings/string/recordings/transcript" \ -H "Content-Type: application/json" \ -d '{ "transcript": [ { "speaker": "Jane Doe", "speaker_id": 1, "language": "en", "words": [ { "text": "Thanks", "start_timestamp": 0, "end_timestamp": 0.4, "language": "en", "confidence": 0.98 }, { "text": "everyone", "start_timestamp": 0.4, "end_timestamp": 0.9, "language": "en", "confidence": 0.97 } ] } ] }'{
"data": {
"type": "meeting_recording",
"id": "2f7a9c1e-4b6d-4e8a-9c0f-1d3b5e7a9c62",
"attributes": {
"_id": "2f7a9c1e-4b6d-4e8a-9c0f-1d3b5e7a9c62",
"meeting_id": "6c8e0a2b-4d5f-4a7b-9c1d-3e5f7a9b1c2d",
"recording_source": "manual_upload",
"status": "Done",
"start_at": "2026-02-01T17:00:00.000Z",
"end_at": "2026-02-01T17:30:00.000Z",
"_created_at": "2026-01-15T09:30:00.000Z",
"_updated_at": "2026-02-01T17:45:00.000Z"
}
}
}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.
Upload a meeting transcript
Creates a recording for a meeting from an externally captured transcript, so meetings recorded outside Clarify can be summarized and searched. Returns the created recording.