# Delete Subscriptions

Delete one or more webhook subscriptions. Returns detailed results for each deletion with partial success support.

Endpoint: (POST) https://api.lusha.com/api/subscriptions/delete

---

Behavior:
- Each subscription is processed independently
- Returns detailed results for each item including deleted subscription info
- Invalid ID formats are gracefully handled and reported as NOT_FOUND
- Duplicate IDs are automatically deduplicated
- Deletion is permanent and cannot be undone

Endpoint: POST /api/subscriptions/delete
Security: ApiKeyAuth

## Request fields (application/json):

  - `ids` (array, required)
    Array of subscription IDs to delete
    Example: ["507f1f77bcf86cd799439011","507f1f77bcf86cd799439012"]

## Response 200 fields (application/json):

  - `total` (integer, required)
    Total number of deletion attempts
    Example: 3

  - `successful` (integer, required)
    Number of successfully deleted subscriptions
    Example: 2

  - `failed` (integer, required)
    Number of failed deletion attempts
    Example: 1

  - `results` (array, required)

## Response 400 fields (application/json):

  - `statusCode` (integer, required)
    HTTP status code
    Example: 400

  - `message` (string, required)
    Error message
    Example: "Validation failed"

  - `errors` (array)
    Detailed error messages (optional, only for validation errors)
    Example: ["entityType must be one of: contact, company"]

## Response 401 fields (application/json):

  - `statusCode` (integer, required)
    HTTP status code
    Example: 400

  - `message` (string, required)
    Error message
    Example: "Validation failed"

  - `errors` (array)
    Detailed error messages (optional, only for validation errors)
    Example: ["entityType must be one of: contact, company"]

## Response 500 fields (application/json):

  - `statusCode` (integer, required)
    HTTP status code
    Example: 400

  - `message` (string, required)
    Error message
    Example: "Validation failed"

  - `errors` (array)
    Detailed error messages (optional, only for validation errors)
    Example: ["entityType must be one of: contact, company"]