REST API/RECORDINGS
Upload a recording
Upload a video file. EdithPro processes it, then transcribes it like any other recording.
On this page
POSThttps://api.edithpro.app/v1/recordings/upload
Processing runs in the background. Watch for the recording.ready webhook, or poll Get a recording until status is ready.
Form fields #
NameTypeDescription
filefile · requiredMP4, MOV or WebM. Up to [5 GB].
titlestringDefaults to the file name.
folder_idstringWhere to put it.
transcribebooleanDefault true.
languagestringTranscript language, for example en. Detected if left out.
Request #
curl -X POST "https://api.edithpro.app/v1/recordings/upload" \ -H "Authorization: Bearer $EDITHPRO_API_KEY" \ -F "file=@walkthrough.mp4" \ -F "title=Onboarding walkthrough" \ -F "folder_id=fld_onboarding"
Response #
Response · 202 Accepted · example
{ "id": "rec_u81zd2", "object": "recording", "title": "Onboarding walkthrough", "status": "processing", "duration": null, "share_url": "https://edithpro.app/v/u81zd2", "thumbnail_url": null, "folder_id": "fld_onboarding", "workspace_id": "ws_64f2a1b3", "source": "upload", "tracks": { "screen": true, "camera": true, "audio": true }, "transcript_status": "processing", "views": 0, "created_by": { "id": "usr_31", "name": "Jane Smith" }, "created_at": "2026-10-06T14:12:09Z"}
Was this page helpful? REST API v1 draft · Edit this page