Publish Draft
publish_draftPublish a DRAFT post now or schedule it; SCHEDULED posts are accepted too, to reschedule or push live. Other statuses fail with "Post is not a draft". A future scheduledAt sets SCHEDULED for that time and queues nothing yet; a past one publishes now. Without scheduledAt, a draft whose planned date (the scheduledAt it was saved with) is still in the future is SCHEDULED for that date, and any other post (an undated draft, a planned date already past, a SCHEDULED post) publishes now. publishNow: true publishes now even when the draft has a planned date; sending it with scheduledAt fails with 400. Read the draft with get_post first and tell the user which of these will happen. Publishing now clears the stored scheduledAt, moves the post to PENDING and queues a publishing job per platform: content reaches the networks within moments and cannot be recalled. Fails if an account was disconnected or a TikTok entry lacks privacyLevel; fix with update_post first. A post whose YouTube video already waits on YouTube (scheduleOnYouTube) fails with 409 SCHEDULED_ON_YOUTUBE, since YouTube publishes it at scheduledAt. Not for new content, use create_post. Returns { postId, queuedPlatforms, isScheduled, scheduledAt }: queuedPlatforms lists the platforms whose publishing job was queued and is empty when the post was scheduled for later, so it confirms queueing, not publishing. Check list_post_results afterwards for per-platform outcomes.
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": "publish_draft"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Post ID with status DRAFT (or SCHEDULED) | |
| timezone | No | IANA timezone stored with the post for display (e.g. "America/New_York"); it does not shift scheduledAt. Omitting it stores UTC, replacing the timezone the draft was saved with, so resend the draft's timezone from get_post to keep it | UTC |
| publishNow | No | Publish now even when the draft has a planned date in the future. Sending it with scheduledAt fails with 400 | |
| scheduledAt | No | Absolute ISO 8601 instant (e.g. "2026-03-15T10:00:00Z"). A future time schedules for that time instead of the draft's planned date; a past time publishes now. Omit to schedule for the planned date when it is still in the future, and to publish now otherwise | |
| workspaceId | No | Workspace to act in: an id from list_workspaces. Omit to act in the workspace list_workspaces marks current. Use the same workspaceId for every call about the same workspace, since ids from one workspace (accounts, posts, uploads) do not exist in another |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes | An object with postId, queuedPlatforms (platforms whose publishing job was queued; empty when scheduled for later), isScheduled, and scheduledAt. |