Schedule post
schedule_postWith post_id and remove: true, remove a finished or canceled post from Kuro's calendar and Needs attention only. Published social-media posts and analytics remain intact. Cancel scheduled posts first; sending posts cannot be removed until they finish. Removal cannot be combined with other edits.
Create, edit or withdraw a post to the reader's connected social accounts. Without post_id it creates one from a ready image, clip or image set in the account (generation_id) or a verified upload (upload_id) — exactly one — with a caption, one target per account and the reader's IANA timezone; title is required when a target is YouTube. With post_id it edits that post — send only what changes — and with post_id and cancel: true it withdraws a draft or a scheduled post.
Timing is one of three. scheduled_for (an ISO time, two minutes to ninety days ahead) schedules it. Neither scheduled_for nor post_now makes a DRAFT on create — nothing goes out, and the reader finds it in the calendar's drafts; on an edit it leaves the timing alone, and draft: true takes a scheduled post's time away. post_now: true sends it immediately and needs the social.publish_now permission, which a connection holds only when the reader granted it; use it only when the reader asked for the post to go out now. Draft and propose; schedule on the reader's go-ahead.
A post to three accounts is ONE post with three targets. Each target carries that platform's options (start from the account's last_options in list_social_accounts, the reader's previous answers) and may carry its own caption when the platforms want different words. An edit's targets replaces the whole list. Accounts are connected only in the app, at /settings/social.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| draft | No | ||
| title | No | ||
| cancel | No | With post_id: withdraw the draft or scheduled post. | |
| remove | No | With post_id only: remove a finished or canceled calendar entry, keeping published social-media posts. | |
| caption | No | ||
| post_id | No | The post to edit or withdraw. Omit to create one. | |
| targets | No | ||
| post_now | No | ||
| timezone | No | The reader's IANA time zone, such as Europe/Paris — the calendar shows the post in it. Required on create. | |
| upload_id | No | Create only, instead of generation_id: the verified uploaded image or clip to post, from list_media. | |
| generation_id | No | Create only: the ready image, clip or image set to post, from list_media. | |
| scheduled_for | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| post | Yes | ||
| message | Yes |