P

Posts

Unschedule post

Cancels a scheduled post before it publishes and puts it back into draft (editable again). Also reverts a linked carousel row to draft.

DELETE/api/public/posts/:id/schedule
cURLDELETE /api/public/posts/:id/schedule
curl -X DELETE "https://postiv.ai/api/public/posts/ID_ID/schedule" \
  -H "Authorization: Bearer pk_postiv_..."
200Response
{
  "success": true,
  "post": {
    "id": "post1...",
    "title": "My post",
    "status": "draft"
  }
}

Authorization

Requires an organization API key with the posts:schedule scope, sent as Authorization: Bearer or x-api-key.

Path parameters

idstringrequired

Resource id from the corresponding list or create endpoint.

Response

The now-draft post.

post.id / titlemixed
post.statusstring

Always 'draft'.

Errors

404post_not_found
400post_not_scheduled: status isn't currently 'scheduled'

Good to know

  • Any member of the post's org may unschedule it, not just the creator.