> ## Documentation Index
> Fetch the complete documentation index at: https://docs.postbreeze.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete a post

> Deletes a post. The row stays in our database for audit purposes, but it's hidden from every listing and from `GET /posts/{postId}` — for your purposes it's gone.

Important: delete does **not** stop a scheduled post from publishing. If the post is scheduled and you want to make sure it doesn't go out, call `POST /posts/{postId}/cancel` first, then delete it.

Only workspace **owners**, **admins**, and **editors** can delete posts.



## OpenAPI

````yaml /openapi.json delete /posts/{postId}
openapi: 3.0.0
info:
  title: Postbreeze API
  description: >-
    Public REST API for scheduling and managing social posts. Authenticate every
    request with `Authorization: Bearer pb_live_…`. All endpoints are scoped to
    a single workspace; an API key issued for workspace A cannot access
    workspace B.
  version: 1.0.0
  contact: {}
servers:
  - url: http://localhost:4100/api/v1
security:
  - bearer: []
tags: []
paths:
  /posts/{postId}:
    delete:
      tags:
        - Posts
      summary: Delete a post
      description: >-
        Deletes a post. The row stays in our database for audit purposes, but
        it's hidden from every listing and from `GET /posts/{postId}` — for your
        purposes it's gone.


        Important: delete does **not** stop a scheduled post from publishing. If
        the post is scheduled and you want to make sure it doesn't go out, call
        `POST /posts/{postId}/cancel` first, then delete it.


        Only workspace **owners**, **admins**, and **editors** can delete posts.
      operationId: PostsV1Controller_remove
      parameters:
        - name: postId
          required: true
          in: path
          description: Prefixed cuid of the post to delete.
          schema:
            example: post_01HZX5T2K9Q3RB6N6JZP3RYV0M
            type: string
      responses:
        '200':
          description: The soft-deleted post id.
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    description: The soft-deleted post id.
        '400':
          description: Validation error
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                    example: 400
                  code:
                    type: string
                    example: VALIDATION_FAILED
                  message:
                    type: string
                  requestId:
                    type: string
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                    example: 401
                  message:
                    type: string
                    example: Unauthorized
                  requestId:
                    type: string
components:
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: API key
      type: http
      description: Your Postbreeze API key

````