Retract a published post (best-effort)
post_unpublishBest-effort delete of a published post on the target platform. Side effects: makes an external HTTP DELETE or update request; DEV.to sets published=false (soft delete); platforms without a delete API return success=false without error. Non-idempotent — calling on an already-deleted URL may return a platform 404. Use post_unpublish to retract a live post; use post_status first to obtain the live_url; use post_publish to re-publish after an unpublish.
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": {
"live_url": "<live_url>",
"channel": "<channel>"
},
"name": "post_unpublish"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| channel | Yes | Channel slug the post was published to, e.g. 'devto', 'hashnode', 'reddit:ClaudeAI'. | |
| live_url | Yes | URL of the live published post to retract, e.g. 'https://dev.to/user/post-slug'. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | Yes | Platform error message; null on success. | |
| success | Yes | Whether the retract succeeded on the platform side. |