Schedules

Find the account

GET /v1/accounts lists the TikTok accounts connected to your Stratos account. Requires schedules:read or schedules:write.

{
  "data": [
    {
      "id": "acct_7f3k2",
      "openId": "-000abc123",
      "platform": "tiktok",
      "handle": "skini",
      "displayName": "Skini",
      "appId": "product_x1y2",
      "provider": "oauth",
      "status": "connected",
      "connected": true
    }
  ]
}

Either id or openId works as tiktokAccountId below. connected: false means the account needs reconnecting in Stratos before it can post (null: that couldn’t be checked just now). An account with an appId only takes that app’s content.

Create a schedule

string

required

Must reference content with approvalStatus: "approved" that has finished slide images (see below).

string

required

The account’s id or openId from GET /v1/accounts.

string

required

ISO 8601. The post goes out at this time; a time that is now or already past sends at once.

string

default:"draft"

"draft" | "publish". See Direct publish.

string

Required when mode: "publish": one of PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR, SELF_ONLY, and one this TikTok account currently allows. Ignored for drafts (the creator picks visibility when they finish the post in TikTok).

Requires schedules:write (and schedules:publish for mode: "publish"). An Idempotency-Key header is honored: a retry with the same key gets the first response back instead of a second post.

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": "acct_7f3k2", "scheduledFor": "2026-10-20T14:00:00Z"}'

201

{
  "data": {
    "id": "b1c2…",
    "contentId": "content_x1y2z3",
    "tiktokAccountId": "acct_7f3k2",
    "scheduledFor": "2026-10-20T14:00:00.000Z",
    "mode": "draft",
    "delivery": "drafts",
    "status": "scheduled",
    "note": null,
    "error": null,
    "tiktokPostId": null,
    "createdAt": "…",
    "updatedAt": "…"
  }
}

delivery says where the post actually lands: "drafts" (the creator’s TikTok drafts, for a final tap in the TikTok app) or "profile" (live).

What can be scheduled

Only content whose slides are finished images on the server: a slideshow created with brief.templateId: "quote-card". A plain slideshow is text only, an illustrated deck’s stored images are the bare artwork (the Stratos app lays the words over them when you open the deck), and hook_video clips aren’t postable from the API yet. Each of those gets a 409 that says so; post them from the Stratos app. This posts through the same TikTok queue the Stratos app itself uses — not a separate reimplementation, so drafts vs. direct post, the compliance fields, pacing and the drafts-box limits match the app exactly.

Statuses

`status`	Meaning
`scheduled`	Waiting in the queue. If the queue is holding it (TikTok’s drafts box is full, the daily limit, pacing), `note` says why and when it tries again.
`processing`	Being sent to TikTok right now
`sent_to_drafts`	In the creator’s TikTok drafts
`published`	Live on TikTok. `tiktokPostId` is set once TikTok gives the public id (for drafts, after the creator posts it).
`failed`	TikTok refused it — `error` has the reason
`cancelled`	Removed from the queue in the Stratos app before it went out

Status is brought up to date when you read the schedule (GET /v1/schedules/{id}, or a list). Schedule webhooks (schedule.sent_to_drafts, schedule.published, schedule.failed) are not delivered yet — see Webhooks — so poll.

Error responses to handle explicitly

Status	Code	Meaning
409	`not_approved`	Content isn’t approved yet — call `/approve` first
409	`no_images` / `not_postable`	Content has no finished slide images the API can post (see above)
409	`slide_missing` / `unsupported_image_format` / `image_too_large` / `too_many_slides`	A slide’s file is gone, isn’t JPEG/WebP, or the deck is too big to post
404	`account_not_found`	No such account on this Stratos account — check `GET /v1/accounts`
409	`account_not_connected` / `account_needs_reauth`	Reconnect the account in Stratos → Accounts
409	`cross_app`	The account posts for a different app than this content
409	`already_scheduled`	This content is already waiting to go to this account (`scheduleId` in the error)
400	`missing_privacy_level` / `invalid_privacy_level`	`mode: "publish"` without a visibility, or one this account doesn’t allow right now
403	`missing_scope`	Key lacks `schedules:publish` for `mode: "publish"`
409 / 502	`tiktok_create_failed`	The TikTok queue refused (409) or couldn’t be reached (502) — the message says which

Read

GET /v1/schedules — schedules:read. Up to 100, latest scheduledFor first.
GET /v1/schedules/{id} — schedules:read.

Delete

DELETE /v1/schedules/{id} — schedules:write. While the post is still waiting (scheduled) it is taken out of the TikTok queue and the schedule is deleted. A post that is already being sent (409 already_sending) or already went out (409 already_sent) can’t be taken back from here — delete it in the TikTok app. Failed and cancelled schedules can always be deleted.

Getting Started

Guides

API Reference

Find the account

Create a schedule

What can be scheduled

Statuses

Error responses to handle explicitly

Read

Delete

​Find the account

​Create a schedule

​What can be scheduled

​Statuses

​Error responses to handle explicitly

​Read

​Delete

Find the account

Create a schedule

What can be scheduled

Statuses

Error responses to handle explicitly

Read

Delete