Submission

Returns the authenticated user's own submissions, newest first, 50 per page.

Uploads the video and queues it for publishing. Pass platform to choose tiktok (the default), instagram or youtube, and account_id to name the account, which must be assigned to a phone.

This returns 201 with status pending (or scheduled when scheduled_at is set); publishing happens afterwards, so poll GET /v1/submissions/{submission} for the outcome, or pass webhook_url to be called when it finishes.

To post one clip to several accounts at once, use POST /v1/submissions/batches instead.

On YouTube, caption is the Short's title: required, and capped at 100 characters instead of 2200.

Poll this to track a submission's progress. When status is failed, the failure object describes the step that failed.

Deletes the submission and its stored video file. Returns 409 unless the submission has reached a terminal status (published, drafted, failed or cancelled): work already queued on a phone cannot be deleted mid-flight.

Cancels a queued or in-progress submission. Returns 403 if the caller does not own it, 404 if it does not exist, and 409 if it has already reached a terminal status.