Schemas

Which platform this account posts to.

The Google account address of this YouTube channel. Only present for YouTube accounts.

pending, approved, declined or failed, or the computed expired once a pending request has aged out.

status is Stripe's own subscription status.

Named scalar values for the workflow's {{placeholders}}.

The phone slot UUID this run was queued against.

What was asked for: macro, command or agent.

queued, running, succeeded, failed or cancelled.

Short human label: workflow name, command op, or agent task summary.

What the run produced, when it succeeded. Shape depends on kind. A get_ip or clipboard_get command returns {"value": "..."}.

Safe, customer-readable reason when status is failed; else null.

Which platform to create the account on. Defaults to tiktok.

Required for TikTok, capped at 4 accounts per phone. Optional for Instagram and YouTube.

The Google account address. Required for YouTube, rejected on every other platform.

Where to post. One entry per account; the same account may not be listed twice. Accounts must belong to you and be assigned to a phone.

Video file, up to 200 MB. Accepted types: MP4, MOV.

The caption posted on TikTok and Instagram destinations, up to 2200 characters. Ignored on YouTube, which takes youtube_title instead.

The Short's title on YouTube destinations, up to 100 characters. Required when any destination is on YouTube.

Save as a draft on the phone instead of publishing. Defaults to false.

When to publish every post in the drop, as an ISO 8601 timestamp in the future. Omit to publish now.

An https URL to POST to as each submission in the drop reaches a terminal status. One delivery per submission, not per drop.

Platform to post to. Defaults to tiktok.

The account to post as.

Deprecated alias for account_id. Still accepted; prefer account_id.

Video file, up to 200 MB. Accepted types: MP4, MOV.

The text posted with the video. On TikTok and Instagram this is the caption, up to 2200 characters, and optional. On YouTube it is the Short's title instead: required, and capped at 100 characters.

When to publish, as an ISO 8601 timestamp in the future. Omit to publish now. A scheduled submission is created with status scheduled and can be cancelled until it starts.

An https URL to POST to once the submission reaches a terminal status (published, drafted, failed or cancelled). See the Webhooks section of the introduction for the payload and signature.

The caption as given; each submission carries what its platform received.

Whether any post in the drop is still scheduled, queued or running.

One submission per destination, in the order they were given.

Which platform this submission was published to.

The drop this was created as part of by POST /v1/submissions/batches, or null for a submission created on its own.

Why the publish did not complete, or null unless status is failed. step names the stage that failed; message is what to do about it. Quote the submission id when contacting support.

When this will publish, or null if it was queued immediately.

Where the completion webhook is delivered, or null if none was asked for.

The Google account address. Only editable on YouTube.

The key webhook deliveries are signed with. Only returned to a token that holds the submissions ability; minted on first read.