---
**📚 Main Documentation:** [Hoko API Documentation (llms.txt)](https://hoko.to/docs/llms.txt)
This is an individual endpoint documentation file. For the complete API reference, see the main documentation above.
---
# (DELETE) Delete customers
Soft-delete existing customers by ID.
**Category:** Customers
## Endpoint

DELETE /api/customers

Soft-delete one or more customers by UUID. Deleted customers are excluded from `GET /api/customers` and future direct updates.

**Endpoint**

```text
DELETE /api/customers
```

## Authentication

Requires authentication with an API key that has the customersWrite scope.

## Request Body

The request body must be an array of customer UUIDs.

```json
[
	"550e8400-e29b-41d4-a716-446655440000",
	"550e8400-e29b-41d4-a716-446655440001"
]
```

## Status Codes

### 200

Customers deleted successfully.

**Request**

```bash
curl -X DELETE "https://hoko.to/api/customers" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '["550e8400-e29b-41d4-a716-446655440000"]'
```

**Response**

```json
{
	"deletedIds": ["550e8400-e29b-41d4-a716-446655440000"]
}
```

### 400

Invalid JSON, invalid customer IDs, duplicate IDs in the request, or a customer that does not belong to the workspace.

### 401

Invalid or missing API key.

### 403

API key does not have the required customersWrite scope.

### 429

Rate limit exceeded. Check X-RateLimit-\* headers for details.

### 500

Unexpected server error.

---

**Back to main documentation:** [Hoko API Documentation (llms.txt)](https://hoko.to/docs/llms.txt)