schedule_post
Schedule a post for a date and time the user names, on one or more platforms. For the next free time in the posting schedule, use queue_post instead; to post right now, publish_post. When a platform has more than one connected account, pass platform_account_ids to pick one (list_connected_accounts gives the ids). If posting-time variance is on, the time is moved by up to half that window so posts don't all land on the exact minute, and the reply says so; pass variance_minutes: 0 for an exact time. All or nothing: if any channel can't be booked, nothing is saved and the error says why. With no scheduled_at, a penciled draft is booked at its penciled time if that is still ahead. Drafts never post. A penciled time only holds the slot. A time within 15 minutes of now books nothing: the reply carries a link the user must open to confirm it. Show the user the link; don't try to confirm it yourself.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"id": "<id>"
},
"name": "schedule_post"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Post ID to schedule | |
| platforms | No | Platforms (defaults to post's existing platforms). Instagram needs an image or video on the post: if it has none, add one with `update_draft` (`images`) first. | |
| workspace | No | Optional: the workspace (client) to answer from for this call only, by name (e.g. 'Acme') or numeric id, as returned by list_workspaces. Leave it out to use the current workspace. It does not change the current workspace; use select_workspace for that. | |
| scheduled_at | No | ISO 8601 datetime (e.g. '2025-03-10T09:00:00Z'). Required unless the post is a draft penciled in for a time still ahead, which is then used. | |
| variance_minutes | No | Optional override for the account's posting-time variance window, 0-60. The stored time is jittered by up to half of it. 0 stores the exact time you asked for. | |
| platform_account_ids | No | Optional map of platform => connected_account_id (numeric id from `list_connected_accounts`). Example: {"twitter": 42} to post to the Twitter account with id 42. Each id must belong to the current account and match the platform. |