Spaces API – Delete Document Endpoint

This endpoint allows authenticated users to delete a specific document (menu item) from a Space. It enforces permission checks, ownership validation, and returns structured JSON responses.

🔗 Endpoint Definition

{
    "title": "Delete Document",
    "description": "Remove a document (menu item) from a space",
    "method": "DELETE",
    "baseUrl": "https://app.docuwriter.ai",
    "endpoint": "/api/spaces/{space}/documents/{spaceMenuItem}",
    "headers": [
        {
            "key": "Authorization",
            "value": "Bearer <token>",
            "required": true
        }
    ],
    "queryParams": [],
    "pathParams": [
        {
            "key": "space",
            "value": "ID or slug of the space",
            "required": true
        },
        {
            "key": "spaceMenuItem",
            "value": "ID of the document/menu item",
            "required": true
        }
    ],
    "bodyType": "none",
    "requestBody": "",
    "formData": [],
    "rawBody": "",
    "responses": {
        "200": {
            "description": "Document deleted successfully",
            "body": "{\n  \"success\": true,\n  \"data\": {\n    \"deleted_document_id\": 42,\n    \"deleted_document_name\": \"API Reference\",\n    \"space_id\": 7\n  },\n  \"message\": \"Document 'API Reference' deleted successfully\"\n}"
        },
        "403": {
            "description": "Forbidden \u2013 user lacks permission",
            "body": "{\n  \"success\": false,\n  \"message\": \"Access denied. You do not have permission to delete documents in this space.\"\n}"
        },
        "404": {
            "description": "Not Found \u2013 space or document invalid",
            "body": "{\n  \"success\": false,\n  \"message\": \"Document does not belong to this space.\"\n}"
        },
        "500": {
            "description": "Server Error \u2013 deletion failed",
            "body": "{\n  \"success\": false,\n  \"message\": \"Failed to delete document: <error details>\"\n}"
        }
    }
}

🔒 Authentication

• Include header:

  Authorization: Bearer <your_token>

• Missing or invalid token yields 401 Unauthorized.

📝 Path Parameters

• space: Unique identifier (ID or slug) of the Space.
• spaceMenuItem: ID of the document (menu item) to delete.

✅ Successful Response (200)

• success: true
• data: - deleteddocumentid: integer
• deleteddocumentname: string
• space_id: integer
• message: Confirmation text

{
  "success": true,
  "data": {
    "deleted_document_id": 42,
    "deleted_document_name": "API Reference",
    "space_id": 7
  },
  "message": "Document 'API Reference' deleted successfully"
}

❗ Error Responses