REST API · v1
Team and editor utilities
Use the authenticated account's active team context. Utility changes preserve source media and use the same ownership, plan and role checks as the app.
https://polished-turtle-977.convex.siteGet an API key/api/v1/team
Read the active team and workspace. Admins and editors can read the member roster; viewers receive a redacted roster.
- Response shape
- { team|null, role|null, members[]|null, workspace|null }
curl --request GET 'https://polished-turtle-977.convex.site/api/v1/team' \
--header "Authorization: Bearer $AUTOCLIP_API_KEY"/api/v1/team/invite-links
Create an editor or viewer link as a team admin. This creates a link without sending an invitation.
- Input
- { role?: editor|viewer, expiresInDays?: 1|7|30, maxUses?: positive integer }
- Response shape
- 201 { id, path, role, expiresAt, maxUses|null, uses }
curl --request POST 'https://polished-turtle-977.convex.site/api/v1/team/invite-links' \
--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/review-queue
List up to 50 pending clips in the active workspace, or the active organization's queue when no workspace is selected.
- Response shape
- { clips[] }
curl --request GET 'https://polished-turtle-977.convex.site/api/v1/review-queue' \
--header "Authorization: Bearer $AUTOCLIP_API_KEY"/api/v1/review-queue/decisions
Approve or reject up to 50 unique clips atomically as an admin or editor. Exact retries preserve review time; this does not publish.
- Input
- { decisions: [{ clipId, decision: approve|reject, note?: up to 500 characters }] }
- Response shape
- { decisions: [{ clipId, decision: approved|rejected, deduplicated }] }
curl --request POST 'https://polished-turtle-977.convex.site/api/v1/review-queue/decisions' \
--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/pronunciations
Save a rule for future voiceovers and dubbing. Matching words update the existing rule; existing audio stays unchanged.
- Input
- { word: 1–64 characters, spokenAs: 1–128 characters }
- Response shape
- { id, word, spokenAs }
curl --request POST 'https://polished-turtle-977.convex.site/api/v1/pronunciations' \
--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/clips/{id}/timeline.xml
Export source cuts, timed text and source audio as 30 fps FCP7 XML for Premiere or DaVinci. Relink originals; rendered caption styles and effects are excluded.
- Input
- Accept: application/json for structured XML and import help; default XML download. Optional ?format=json|xml
- Response shape
- XML file or { xml, filename, sourceFileName, help }
curl --request GET 'https://polished-turtle-977.convex.site/api/v1/clips/{id}/timeline.xml' \
--header "Authorization: Bearer $AUTOCLIP_API_KEY"