antworkDOCS

Deleting a post

Cancel a scheduled post or remove a draft. The live post stays up unless you ask for it to go too.

DELETEhttps://antwork.io/api/v1/posts/{id}Scopewrite

Request

DELETE /api/v1/posts/{id} cancels a scheduled post or removes a draft. A published post is soft-deleted so its engagement history survives, and disappears from every read on this API either way. Needs the write scope.

curl -X DELETE https://antwork.io/api/v1/posts/pQ7x... \
  -H "Authorization: Bearer $ANTWORK_API_KEY"

The post on the platform is left alone unless you ask. ?deleteFromPlatform=true also queues deletion of the live post, which is irreversible and visible to other people. Removing a post from Antwork and deleting it from LinkedIn are different intentions, so the API does not guess.

Response

200 OK
{
  "object": "post_deleted",
  "id": "pQ7x...",
  "softDeleted": true,
  "platformDeletionQueuedFor": ["linkedin"]
}
softDeleted: true in the response means the document survives for analytics, not that the post is still visible. platformDeletionQueuedFor lists the platforms a deletion was queued for, which happens in the background like publishing does.