Cancel a pending scheduled X post and refund any credits charged at schedule-time.
Cancels a scheduled X post that hasn't published yet. Only posts still in pending status can be canceled — once the background dispatcher has claimed a post for publishing (processing) or it has already posted/failed, this returns 409.
If credits were charged when the post was scheduled, they're refunded automatically on a successful cancel.
DELETE https://eranol.com/api/v1/social/x/scheduled-posts/{id}
| Field | Type | Required | Notes |
|---|---|---|---|
id | string | Yes | The scheduled post's id, from the list endpoint or the original schedule response's scheduled_post_id |
DELETE https://eranol.com/api/v1/social/x/scheduled-posts/a1b2c3d4-...
{
"success": true
}
| Status | Meaning |
|---|---|
400 | Missing/invalid required field, or invalid scheduled_for |
401 | Missing or invalid API key |
402 | Insufficient credits |
404 | Scheduled post not found, or does not belong to this account |
409 | The post can no longer be canceled (already claimed for publishing, already posted, already failed, or already canceled) |
500 | Internal server error — try again or contact support |