v1

latestOpenAPI 3.0.32026-07-13218142597.2 KB
Blog Post

Delete blog post

Delete a blog post by id.

By default this will delete blog posts that are non-drafts. To delete a blog post that is a draft, the endpoint must be called on a draft with the following param draft=true. Discarded drafts are not sent to the trash and are permanently deleted.

Deleting a blog post that is not a draft moves the blog post to the trash, where it can be restored later. To permanently delete a blog post (or "purge" it), the endpoint must be called on a trashed blog post with the following param purge=true.

Permissions required: Permission to view the blog post and its corresponding space. Permission to delete blog posts in the space. Permission to administer the space (if attempting to purge).

delete/blogposts/{id}

Path parameters

idinteger required

The ID of the blog post to be deleted.

Query parameters

purgeboolean

If attempting to purge the blog post.

draftboolean

If attempting to delete a blog post that is a draft.

Response

Returned if the blog post was successfully deleted.