# POST /opportunities/bulk-delete

**Resource:** [Opportunities](./opportunities.md)  
**Scopes:** `opportunities:delete`  
**Write operation:** yes

Permanently delete up to 100 opportunities in a single request. Each opportunity is cascade-deleted including its products, pipeline placements, contacts, and users. Returns a count of deleted records and any IDs that failed. Cannot be undone. Legacy alias: POST /deals/bulk-delete.

## Parameters

| Name | In | Type | Required | Description |
|------|----|------|----------|-------------|
| `ids` | body | uuid[] | yes | Array of opportunity UUIDs to delete (max 100) |

## Request example

```bash
curl -X POST \
  "https://api.trustpager.com/functions/v1/api/v1/opportunities/bulk-delete" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ids":["uuid-1","uuid-2","uuid-3"]}'
```

## Response example

```json
{
  "data": { "success": true, "deleted": 3 },
  "meta": { "credits_remaining": 9450 }
}
```

---
Base URL: `https://api.trustpager.com/functions/v1/api/v1` — Auth: `Authorization: Bearer YOUR_API_KEY`