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/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.jsonSave the input fields as request.json before running a write request. Replace path placeholders with your own IDs.
/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.jsonSave the input fields as request.json before running a write request. Replace path placeholders with your own IDs.
/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.jsonSave the input fields as request.json before running a write request. Replace path placeholders with your own IDs.
/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"/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"/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.jsonSave the input fields as request.json before running a write request. Replace path placeholders with your own IDs.
/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"/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.jsonSave the input fields as request.json before running a write request. Replace path placeholders with your own IDs.