Approve a post
approve_postApprove a team member's pending post to schedule or publish it to its platforms. Preview the exact output first, then confirm to send.
Instructions
Approve a team member's post waiting for approval: Upload-Post creates its scheduled job and publishes it to the post's platforms. Owner and Admin only. version is the item's version as reviewed; if the post was edited since, the call answers 409 approval_version_changed with the current item, which should be reviewed again. When it publishes: scheduled_date (+ timezone) if sent; now for immediate posts or with publish_now; the next free queue slot for queued posts; otherwise the post's own date. 409 approval_expired (an Editor's post whose date has passed), scheduled_date_in_past (a draft whose proposed date passed: send a date or publish_now), approval_closed; 429 when the monthly upload allowance is used up. Not generally available yet: until post approvals are switched on for the account, these calls answer 503 post_approvals_disabled (the feature is off, not a temporary failure). Needs the user's approval: call it first without confirmed to get a preview (nothing is sent), show the user exactly what will go out, and repeat the call with confirmed: true only after they approve.
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": {
"approval_id": "<approval_id>",
"version": "<version>"
},
"name": "approve_post"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| comment | No | Note for the author. | |
| version | Yes | The item's `version` that was reviewed. | |
| timezone | No | IANA timezone for scheduled_date. | |
| confirmed | No | Set to true only after the user has seen the preview this tool returns without it and approved it. Without it nothing is sent. | |
| approval_id | Yes | `approval_id` from list_pending_approvals (also returned by an upload that went to approval). | |
| publish_now | No | Publish right away. | |
| scheduled_date | No | ISO 8601 date to publish at instead of the post's own. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | No |