Withdraw a post awaiting approval
withdraw_pending_postWithdraw or discard a post awaiting approval so it will not be published and its media is deleted; this action is irreversible.
Instructions
Withdraw (its author) or discard (a reviewer) a post waiting for approval: it becomes withdrawn, will not be published and its media is deleted. It cannot be undone. 409 approval_closed when it was already decided. 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>"
},
"name": "withdraw_pending_post"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| 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). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | No |