Delete a case's conversations (internal)

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL


        
          
            https://docs.usehearsay.com/mcp

Standard setup for AI tools providing an mcp.json file

{
  "integrations MCP server": {
    "url": "https://docs.usehearsay.com/mcp"
  }
}

DELETE /admin/case/delete-case-conversations

Access token

Removes every conversation from the case found by caseId or caseSlug in the organization given by orgId or orgSlug: conversations linked only to this case are deleted and the rest are unlinked. With deleteCaseIfNoConversationsLeft, a case left with no conversations is soft-deleted along with its access, extraction codes, comments, data sources and files. Returns a message with the counts, or 404 for an unknown organization or case. Super admin only.

application/json

Body Required

caseId string

required if caseSlug not sent
caseSlug string

required if caseId not sent
orgId string

required if orgSlug not sent
orgSlug string

required if orgId not sent
deleteCaseIfNoConversationsLeft boolean

Default value is false.

Responses

200 application/json
Hide response attributes Show response attributes object
- data object Required
  
  Hide data attributes Show data attributes object
  
  message string Required
  
  isSuccess boolean Required
- statusCode number Required
- timestamp string(date-time) Required

DELETE /admin/case/delete-case-conversations

curl \
 --request DELETE 'http://api.example.com/admin/case/delete-case-conversations' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{
  "caseId": "string",
  "caseSlug": "string",
  "orgId": "string",
  "orgSlug": "string",
  "deleteCaseIfNoConversationsLeft": false
}'

Request examples

{
  "caseId": "string",
  "caseSlug": "string",
  "orgId": "string",
  "orgSlug": "string",
  "deleteCaseIfNoConversationsLeft": false
}

Response examples (200)

{
  "data": {
    "message": "Done",
    "isSuccess": true
  },
  "statusCode": 200,
  "timestamp": "2026-01-15T10:15:00.000Z"
}