AutoClip

REST API · v1

Posting status and recovery

Requests are confirmed separately from publication. Availability hints are rechecked by the server. Provider retry and cancellation remain staged where enabled; unavailable controls must not be bypassed.

https://polished-turtle-977.convex.siteGet an API key
POST

/api/v1/post-tasks

Send a finished clip to one of your connected social accounts.

Input
{ clipId, socialAccountId, caption?, finishedSelection? }
Response shape
201 { id, platform, status: pending, xSurchargeCharged }
curl --request POST 'https://polished-turtle-977.convex.site/api/v1/post-tasks' \
  --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/publish-schedules

Schedule your clips

Input
{ clipId, socialAccountId, scheduledAt: futureUnixMilliseconds, caption?, finishedSelection? }
Response shape
201 { id, status: pending }
curl --request POST 'https://polished-turtle-977.convex.site/api/v1/publish-schedules' \
  --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/publish-schedules/bulk

Schedule your clips

Input
{ entries: [{ clipId, socialAccountId, scheduledAt, caption?, finishedSelection? }] } // 1–200 entries
Response shape
201 { created, results: [{ ok, id?, code? }] }
curl --request POST 'https://polished-turtle-977.convex.site/api/v1/publish-schedules/bulk' \
  --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/post-tasks

Read posting requests and operation status.

Response shape
{ postTasks: [{ id, clipId|null, platform, status, scheduledFor, sourceResolution, providerOperationStatus, providerCancellationAvailable, providerCreateRetryAvailable, providerEditAvailable }] }
curl --request GET 'https://polished-turtle-977.convex.site/api/v1/post-tasks' \
  --header "Authorization: Bearer $AUTOCLIP_API_KEY"
GET

/api/v1/publish-schedules

Read schedules and available operations.

Response shape
{ schedules: [{ id, clipId|null, platform, status, scheduledFor, sourceResolution, providerOperationStatus, providerCancellationAvailable, providerCreateRetryAvailable, providerEditAvailable }] }
curl --request GET 'https://polished-turtle-977.convex.site/api/v1/publish-schedules' \
  --header "Authorization: Bearer $AUTOCLIP_API_KEY"
PUT

/api/v1/publish-schedules/{id}

Request a schedule update; update_requested awaits confirmation.

Input
{ scheduledAt: unixMilliseconds }
Response shape
200 { id, scheduledFor, status: updated } or 202 { id, scheduledFor, status: update_requested }
curl --request PUT 'https://polished-turtle-977.convex.site/api/v1/publish-schedules/{id}' \
  --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.

DELETE

/api/v1/publish-schedules/{id}

Request cancellation; only cancelled confirms completion.

Response shape
200 { ok: true, id, status: cancelled } or 202 { ok: true, id, status: cancellation_requested }
curl --request DELETE 'https://polished-turtle-977.convex.site/api/v1/publish-schedules/{id}' \
  --header "Authorization: Bearer $AUTOCLIP_API_KEY"
POST

/api/v1/publish-schedules/{id}/retry

Retry a proven no-create failure without an additional credit charge. A past scheduled time publishes immediately.

Input
{ confirm: true }
Response shape
202 { id, status: retry_requested }; 409 PROVIDER_CREATE_RECONCILIATION_REQUIRED when the earlier outcome is uncertain

This endpoint requires confirmation. Review the action before sending confirm: true.

curl --request POST 'https://polished-turtle-977.convex.site/api/v1/publish-schedules/{id}/retry' \
  --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.