Social publishing

Post a video to one of the user’s connected social accounts, then poll for the result. The REST equivalents are POST, GET and DELETE /v1/videos/{id}/publish, and GET /v1/social-accounts. A publish posts under the user’s own account, often publicly, so confirm the destination, text and privacy with the user before calling publish_to_social. Before publishing:

• The account must already be connected in Tella, under Settings → Connections or Share → Publish. These tools can’t connect one; an unconnected destination returns a forbidden error.
• Publishing uploads an export with the export settings you pass. Tella reuses a finished or running export with those settings, or starts one, so you don’t need to call export_video first. The publication stays queued while the export renders. A plan that doesn’t include the export’s resolution or frame rate returns a forbidden error.
• TikTok isn’t available: its consent form must be completed in the Tella app.
• A user can connect several accounts per platform, such as two YouTube channels. Call list_social_accounts and pass the chosen one’s id as accountId. Without it, the oldest connected account for the destination posts.

Typical agent flow:

1. list_social_accounts if the user has several accounts for the destination
2. Confirm the destination, account, text and privacy with the user
3. publish_to_social with any export settings (resolution, fps, subtitles, speed), once per account. Each call returns a queued publication
4. list_social_publications until each publication is completed (read its url) or failed (read its error)

To post later, pass scheduledAt to publish_to_social. The publication stays queued with that scheduledAt until its time, and cancel_scheduled_publication takes it back before then. Tella exports the video right away, so edits made after scheduling aren’t in the post.

​

publish_to_social

Start a publish to one destination and account. Returns immediately with a queued publication. One publish per destination and account runs at a time; starting another to the same account while one is queued or running returns a conflict error. Publishes to different accounts run side by side. Publishing again after one completes creates a second post. Facebook destinations post to the default Page set in Settings → Connections, else the first Page the account manages. Instagram destinations likewise post to the default Instagram account. Unlike the app, publish_to_social doesn’t append chapters to a YouTube description; read them with get_chapters and include them in description if you want them.

​

cancel_scheduled_publication

Cancel a scheduled publish before it goes out. Only a publication that is still queued with a scheduledAt can be cancelled; once it starts going out, this returns a conflict error. Returns the publication with status cancelled.

​

list_social_accounts

The accounts the user has connected in Tella that publish_to_social can post with. Takes no parameters. Each account has:

​

list_social_publications

The latest publish of a video to each destination and account, including publishes made in the Tella app (TikTok among them). Poll this after publish_to_social. Each publication has:

​

Destination limits

Tella checks these before starting a publish and returns a bad_request error naming the rule a video breaks. Lengths are of the export, so a 2x export is half as long. File size is checked after the export, just before uploading, so an oversized export shows up as a failed publication rather than an error on the call.