Delete email threads

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 /local-emails/{caseId}/threads

Access token

Permanently deletes threads from the case, with their emails and attachments, and updates the case's data counts.

Path parameters

caseId string Required

application/json

Body Required

threadIds array[string] Required

Array of email thread mongo ids to delete.

At least 1 but not more than 1000 elements.

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 /local-emails/{caseId}/threads

curl \
 --request DELETE 'http://api.example.com/local-emails/{caseId}/threads' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{
  "threadIds": [
    "string"
  ]
}'

Request examples

{
  "threadIds": [
    "string"
  ]
}

Response examples (200)

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