REST API · v1
Full-video editor imports
Import a supported public video as one complete editable timeline. Duration and browser playback are verified before the clip is created. Keep operationId stable across retries; source_ready provides editorPath while transcription continues.
Full-video URL imports support up to 4 hours, within your plan's limit.
https://polished-turtle-977.convex.siteGet an API key/api/v1/editor-imports
Start a full-source import without highlight selection. Metered plans use the manual editor's 10-credit minimum; final pricing uses measured duration.
- Input
- { sourceUrl, operationId: stable 16–100 character token, videoTitle?: up to 200 characters }
- Response shape
- 202 EditorImportStatus
curl --request POST 'https://polished-turtle-977.convex.site/api/v1/editor-imports' \
--header "Authorization: Bearer $AUTOCLIP_API_KEY" \
--header "Content-Type: application/json" \
--data @request.jsonSave the input fields as request.json before running a write request. Replace path placeholders with your own IDs.
/api/v1/editor-imports/{jobId}
Read your import status, actual charge, refund flag, and editor destination.
- Response shape
- { jobId, clipId|null, state: pending|importing|source_ready|ready|failed|cancelled, editorPath|null, durationSec|null, creditsCharged, creditsRefunded, error|null }
curl --request GET 'https://polished-turtle-977.convex.site/api/v1/editor-imports/{jobId}' \
--header "Authorization: Bearer $AUTOCLIP_API_KEY"/api/v1/editor-imports/{jobId}
Cancel an unfinished import and refund an eligible charge once. Completed projects remain available. The operation ID cannot be reused for a fresh import.
- Input
- { confirm: true }
- Response shape
- EditorImportStatus
This endpoint requires confirmation. Review the action before sending confirm: true.
curl --request DELETE 'https://polished-turtle-977.convex.site/api/v1/editor-imports/{jobId}' \
--header "Authorization: Bearer $AUTOCLIP_API_KEY" \
--header "Content-Type: application/json" \
--data @request.json