> ## 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 workspace

> Permanently deletes a workspace and everything inside it.

This wipes:

- All connected social accounts
- All scheduled and draft posts
- The media library and folders
- Team memberships and pending invites

There's no undo. If you just want to stop posting from a workspace, disconnect its social accounts instead.

Only the workspace **owner** can delete it.



## OpenAPI

````yaml /openapi.json delete /workspaces/{workspaceId}
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:
  /workspaces/{workspaceId}:
    delete:
      tags:
        - Workspaces
      summary: Delete workspace
      description: >-
        Permanently deletes a workspace and everything inside it.


        This wipes:


        - All connected social accounts

        - All scheduled and draft posts

        - The media library and folders

        - Team memberships and pending invites


        There's no undo. If you just want to stop posting from a workspace,
        disconnect its social accounts instead.


        Only the workspace **owner** can delete it.
      operationId: WorkspacesController_remove
      parameters:
        - name: workspaceId
          required: true
          in: path
          description: Prefixed cuid of the workspace to delete.
          schema:
            example: ws_01HZX5T2K9Q3RB6N6JZP3RYV0M
            type: string
      responses:
        '200':
          description: The deleted workspace id.
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    description: The deleted workspace 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

````