OverviewProductsPlatformsAPI ReferenceResources
Posts

Delete post

DELETEhttps://zernio.com/api/v1/posts/{postId}

Delete a post from Zernio. Upload quota is automatically refunded for draft and scheduled posts.

Any status except published can be deleted:

  • draft
  • scheduled
  • publishing
  • failed
  • partial
  • cancelled

Published posts cannot be deleted; use the Unpublish endpoint instead.

Authentication

AuthorizationBearer tokenRequired

API key authentication: send your Zernio API key in the Authorization header, prefixed with Bearer.

Path parameters

postIdstringRequired

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.
DELETE/v1/posts/{postId}
import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.posts.deletePost({  path: {    postId: 'post_abc123',  },});console.log(data);
{  "message": "Post deleted successfully"}
OpenAPI specification
Was this page helpful?