Schedules - Stratos AI

Create a schedule

string

required

Requires schedules:write (and schedules:publish for mode: "publish") and an Idempotency-Key header.

curl -X POST https://www.try-orbit.com/api/v1/schedules \
  -H "Authorization: Bearer $STRATOS_API_KEY" -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"contentId": "content_x1y2z3", "tiktokAccountId": "...", "scheduledFor": "2026-08-20T14:00:00Z"}'

Error responses to handle explicitly

Status	Code	Meaning
409	`not_approved`	Content isn’t approved yet — call `/approve` first
400	`missing_privacy_level`	`mode: "publish"` without `privacyLevel`
403	`missing_scope`	Key lacks `schedules:publish` for `mode: "publish"`
409	`no_images`	Content has no rendered slide images — see the content reference
502	`tiktok_create_failed` / `tiktok_publish_failed`	TikTok itself rejected the request — the message is TikTok’s own error text

This posts through the same TikTokHub integration the Stratos AI app itself uses — not a separate reimplementation, so behavior (drafts vs. direct post, compliance fields) matches the app exactly.

List / delete

GET /v1/schedules — schedules:read
DELETE /v1/schedules/{id} — schedules:write. Only works while status is still "pending".

⌘I