Schedule, reschedule, or cancel a post
Schedule an approved draft at an explicit time and IANA timezone, then use the scheduled action ID for later changes.
On this page
Scheduling is a separate mutation from draft creation. Confirm the post, account, media, caption, exact time, and IANA timezone before calling the schedule tool. MCP intentionally does not expose a publish-now action.
The schedule response returns a scheduled_post_id. Keep that ID: reschedule and cancel operations require it and cannot infer a scheduled action from a post ID.
Schedule at an explicit local time
ISO 8601 scheduled_for + IANA timezone{
"tool": "schedule_console_publishing_post",
"arguments": {
"post_id": "22222222-2222-4222-8222-222222222222",
"scheduled_for": "2030-07-15T10:00:00+09:00",
"timezone": "Asia/Tokyo"
}
}{
"scheduled_post": {
"id": "44444444-4444-4444-8444-444444444444",
"post_id": "22222222-2222-4222-8222-222222222222",
"scheduled_for": "2030-07-15T01:00:00Z",
"display_scheduled_for": "2030-07-15T10:00:00+09:00",
"timezone": "Asia/Tokyo",
"status": "PENDING"
}
}Reschedule by scheduled action ID
Reschedule only an eligible PENDING, QUEUED, CLAIMED, FAILED action. Use its scheduled_post_id and confirm the replacement time and timezone.
{
"tool": "reschedule_console_publishing_scheduled_post",
"arguments": {
"scheduled_post_id": "44444444-4444-4444-8444-444444444444",
"scheduled_for": "2030-07-15T13:00:00+09:00",
"timezone": "Asia/Tokyo"
}
}Cancel without deleting the draft
Cancellation uses the scheduled action ID and leaves the draft intact. Confirm the cancellation, then re-read before repeating it after an uncertain response.
{
"tool": "cancel_console_publishing_scheduled_post",
"arguments": {
"scheduled_post_id": "44444444-4444-4444-8444-444444444444"
}
}Inspect status and analytics
PENDING, QUEUED, CLAIMED, FAILEDChangeableMay be rescheduled or cancelled after explicit confirmation.RUNNINGIn progressWait and re-read; do not issue a conflicting schedule mutation.COMPLETED, CANCELLED, SKIPPEDTerminalInspect the current post and schedule before deciding on new work.{
"tool": "list_console_publishing_scheduled_posts",
"arguments": {
"statuses": [
"PENDING",
"QUEUED",
"CLAIMED",
"FAILED"
],
"limit": 50
}
}