docs: add DELETE /api/chats reference

api-reference/chat/delete.mdx

@@ -0,0 +1,4 @@
+---
+title: 'Delete Chat'
+openapi: delete /api/chats
+---

api-reference/openapi.json

@@ -1243,6 +1243,82 @@
             }
           }
         }
+      },
+      "delete": {
+        "description": "Delete a chat room by ID. This operation also removes related room records (memory emails, memories, room-report links, and segment-room links) before deleting the room itself.",
+        "requestBody": {
+          "description": "Chat deletion parameters",
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/DeleteChatRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Chat deleted successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/DeleteChatResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Bad request - invalid parameters or validation error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/DeleteChatErrorResponse"
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Unauthorized - invalid or missing API key",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Error"
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Forbidden - API key does not have access to this chat",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Error"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Not found - chat room does not exist",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/DeleteChatErrorResponse"
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "Server error - failed to delete chat",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/DeleteChatErrorResponse"
+                }
+              }
+            }
+          }
+        }
       }
     },
     "/api/chats/compact": {
@@ -6560,6 +6636,65 @@
           }
         }
       },
+      "DeleteChatRequest": {
+        "type": "object",
+        "required": [
+          "id"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "The unique identifier (UUID) of the chat room to delete."
+          }
+        }
+      },
+      "DeleteChatResponse": {
+        "type": "object",
+        "required": [
+          "status",
+          "id",
+          "message"
+        ],
+        "properties": {
+          "status": {
+            "type": "string",
+            "enum": [
+              "success"
+            ],
+            "description": "Status of the request"
+          },
+          "id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "The UUID of the deleted chat room."
+          },
+          "message": {
+            "type": "string",
+            "description": "Success message describing the deletion result."
+          }
+        }
+      },
+      "DeleteChatErrorResponse": {
+        "type": "object",
+        "required": [
+          "status",
+          "error"
+        ],
+        "properties": {
+          "status": {
+            "type": "string",
+            "enum": [
+              "error"
+            ],
+            "description": "Status of the request"
+          },
+          "error": {
+            "type": "string",
+            "description": "Error message describing what went wrong."
+          }
+        }
+      },
       "UIMessage": {
         "type": "object",
         "description": "A message in the chat conversation. See https://ai-sdk.dev/docs/reference/ai-sdk-core/ui-message for details.",

docs.json

@@ -47,6 +47,7 @@
               "api-reference/chat/chats",
               "api-reference/chat/create",
               "api-reference/chat/update",
+              "api-reference/chat/delete",
               "api-reference/chat/generate",
               "api-reference/chat/stream",
               "api-reference/chat/compact"
@@ -323,4 +324,4 @@
     "og:site_name": "Recoup",
     "twitter:card": "summary_large_image"
   }
-}
+}