Submission
Submit a video
Uploads the video and queues it for publishing on the phone that owns the
account. Pass platform to post to tiktok (the default), instagram or
youtube, and account_id to name the account. The video is NOT published
inline: this returns 201 with status pending, so poll
GET /v1/submissions/{submission} for the outcome. The target account must
already be logged in and assigned to a phone.
On YouTube the text is the Short's TITLE, so caption is required there and
capped at 100 characters rather than 2200.
Submit a video › Request Body
videoplatformPlatform to post to. Defaults to tiktok.
account_idThe account to post as.
tik_tok_account_idDeprecated alias for account_id. Still accepted; prefer account_id.
captionThe text posted with the video. On TikTok and Instagram this is the caption and may be up to 2200 characters; omit it to post without one. On YouTube it is the Short's title instead: required, and capped at 100 characters. Omitting it on YouTube is rejected — YouTube names an untitled Short after the date it was uploaded.
draftSubmit a video › Responses
SubmissionResource
Get a video submission
Poll this to track a submission's progress. When status is failed,
the failure object describes the step that failed.
path Parameters
submissionThe submission ID
Get a video submission › Responses
SubmissionResource
Delete a video submission
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.
path Parameters
submissionThe submission ID
Delete a video submission › Responses
No content

