AutoClip

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
GET

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

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

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

GET

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

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

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

POST

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

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

GET

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

/api/v1/clips/{id}/share

Enable or disable an owned ready clip's public link. Disabling is available after downgrade; no message or social post is sent.

Input
{ shared?: boolean } (default true)
Response shape
{ isPublic, shareUrl: relative app path }
curl --request POST 'https://polished-turtle-977.convex.site/api/v1/clips/{id}/share' \
  --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.