Delete a mailbox's imported emails from a case (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/email/{caseId}/imported-emails/{providerId}

Access token

Deletes every email thread, email and attachment imported into the case from email account providerId, then rolls back the case's collection status for that account. Runs synchronously and reports how many threads were deleted; returns 404 for an unknown case or account. Super admin only.

Path parameters

caseId string Required

Id of the case the emails were imported into
providerId string Required

Id of the UserEmailDataProvider (the imported email account)

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/email/{caseId}/imported-emails/{providerId}

curl \
 --request DELETE 'http://api.example.com/admin/email/{caseId}/imported-emails/{providerId}' \
 --header "Authorization: Bearer $ACCESS_TOKEN"

Response examples (200)

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