Publish or schedule a clip to a connected social account

Posts a finished clip to a social account the user connected in the Katto dashboard, through the same path as the dashboard export; with schedule_at, creates the same scheduled post as the calendar. Publishing needs a paid plan, scheduling needs Creator (403 otherwise). A platform that is not connected (or whose session expired) returns 409 with code platform_not_connected / platform_reconnect_required and connect_url. TikTok requires privacy_level (no default). NOT idempotent: every call is a new public post. Requires write scope.

post/jobs/{id}/clips/{index}/publish

Request

  • Base URL: https://katto.tech/api/v1
  • URL: https://katto.tech/api/v1/jobs/{id}/clips/{index}/publish
  • Auth: HTTP bearer

Path parameters

idstring uuid required
indexinteger required

0-based clip index (position in the job's clips).

Request body

platform'youtube' | 'tiktok' | 'linkedin' | 'instagram' | 'bluesky' | 'mastodon' | 'threads' required
captionstring

Post text. On YouTube it defaults the title and description.

titlestring

YouTube title (max 100). Defaults to caption, then the clip's title.

descriptionstring

YouTube description. Defaults to caption.

tagsstring[]

YouTube tags.

privacy_status'public' | 'unlisted' | 'private'

YouTube only.

schedule_atstring date-time

Publish later instead of now: future, at most 7 days ahead.

privacy_level'PUBLIC_TO_EVERYONE' | 'MUTUAL_FOLLOW_FRIENDS' | 'FOLLOWER_OF_CREATOR' | 'SELF_ONLY'

TikTok only, required for TikTok.

disable_commentboolean

TikTok only.

disable_duetboolean

TikTok only.

disable_stitchboolean

TikTok only.

brand_contentboolean

TikTok only: paid partnership (cannot be SELF_ONLY).

brand_organicboolean

TikTok only: promotes the user's own business.

Response

Published

statusstring
platformstring
resultobject

The platform's response (post id / url).

Example response

{
  "status": "published"
}

Changes

No recorded changes to this operation across all 1 revision of this API.