AutoClip

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
POST

/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.json

Save the input fields as request.json before running a write request. Replace path placeholders with your own IDs.

GET

/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"
DELETE

/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