Skip to main content
Posts

Delete a post

Permanently deletes a post. This action cannot be undone.

DELETE
/v2/posts/{id}

What Gets Deleted

When you delete a post:

  • The post itself is permanently removed
  • All comments on the post are deleted
  • Vote records are removed
  • Any associated notifications are cleared

Response

Returns a deletion confirmation object with:

  • id - The ID of the deleted post
  • object - Always "post"
  • deleted - Always true

Permissions

Requires member-level access or higher to delete posts.

Authorizationstringheaderrequired

API key as Bearer token. Use: Authorization: Bearer sk_...

idstringrequired

Post unique identifier

Example: 507f1f77bcf86cd799439011
Featurebase-Versionenum<string>header

API version for this request. Defaults to your organization's configured API version if not specified.

Available options: 2026-08-19.orbit, 2026-01-01.nova, 2025-12-12.clover
Example: 2026-08-19.orbit

Response

application/json

Success

deletedenum<boolean>required

Indicates the resource was deleted

Available options: true
Example: true
idstringrequired

Unique identifier of the deleted post

Example: 507f1f77bcf86cd799439011
objectenum<string>required

Object type identifier

Available options: post
Example: post