Delete post
Delete a post from Zernio. Upload quota is automatically refunded for draft and scheduled posts.
Any status except published can be deleted:
draftscheduledpublishingfailedpartialcancelled
Published posts cannot be deleted; use the Unpublish endpoint instead.
Authentication
API key authentication: send your Zernio API key in the Authorization header, prefixed with Bearer.
Path parameters
Responses
Success· the request worked
Errors· the request failed
How it behaves
Stopping pending entries
Deleting a publishing or partial post is how you stop entries that are still pending, for example entries held on a disconnected account.
It removes the whole post record from Zernio, including the entries that were already published. It does not remove anything already live on a platform (use Unpublish for that first if needed).
An entry that a worker has already started sending when you delete may still go out. It may also fail, because media uploaded to Zernio and not used by another post is deleted with the post.
Side effects
- Analytics for entries already published are removed too.
- Deleting frees the content for re-creation, so the same caption and media are no longer reported as a duplicate.
Update post
Update an existing post. Draft, scheduled, failed, partial, and cancelled posts can be edited. Published posts can only have their recycling config updated. To promote a draft to scheduled, send `isDraft: false` together with `scheduledFor` (or `publishNow: true`, or `queuedFromProfile`). If `isDraft` is omitted the post keeps its current draft status, so sending only `scheduledFor` to a draft returns 200 but the post remains a draft. Non-draft updates run the same per-platform validation as post creation (media requirements, platform-specific field rules, etc.) against the resulting platforms, returning 400 on failure.
Unpublish post
Deletes a published post from the specified platform. The post record in Zernio is kept but its status is updated to cancelled. Not supported on Instagram, TikTok, or Snapchat. Threaded posts delete all items. YouTube deletion is permanent.