Delete Folder
DELETE /api/writing/folders/{folder_id}
🗑️ Delete a folder.
Deletes a folder. If folder has children, must specify delete_contents=true.
Args: folder_id: Unique folder identifier service: Injected DocumentCategoriesService instance delete_contents: Whether to delete child folders (default: false)
Returns: WritingFolderDeleteResponse: Deletion confirmation with timestamp
Raises: HTTPException 404: If folder not found HTTPException 400: If folder has children and delete_contents is false HTTPException 500: If folder deletion fails
Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”Folder ID
Folder ID
Query Parameters
Section titled “Query Parameters ”Delete child folders and move documents to root
Delete child folders and move documents to root
Responses
Section titled “ Responses ”Successful Response
Response model for folder delete operations in Writing Studio.
Confirms successful folder deletion with operation metadata.
Fields:
success: Whether the delete operation succeededfolder_id: ID of the deleted folderdeleted_at: ISO 8601 timestamp of deletion
Usage: DELETE /api/creative/categories/folders/{folder_id} returns this model.
JSON Example:
{
"success": true,
"folderId": "folder_abc123",
"deletedAt": "2025-12-04T11:00:00Z"
}object
Delete operation success status
Deleted folder ID
Deletion timestamp (ISO 8601)
Validation Error