# Delete posts

Deletes posts for moderation purposes. Can delete a single post by its ID or all posts associated with a report. The deletion is permanent and includes creating audit logs and report notes. When deleting via reportId, all posts referenced in the report are deleted and the report is marked as actioned.

RBAC: requires Reports.Manage

Endpoint: POST /api/v1/admin/posts/delete
Version: 1.0
Security: 

## Request fields (application/json):

  - `postId` (string,null)
    ID of a specific post to delete. Mutually exclusive with reportId.
    Example: "us_01hxcvk1hjexere4pvtrj0ymqq"

  - `reportId` (string,null)
    ID of a report whose associated posts should be deleted. Mutually exclusive with postId.
    Example: "us_01hxcvk1hjexere4pvtrj0ymqq"

  - `reason` (string, required)
    Reason for deleting the post(s). Will be recorded in audit logs and report notes.
    Example: "Violates community guidelines - hate speech"

## Response 401 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation

## Response 403 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation

## Response 404 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation


## Response 400 fields