Delete Customer
Delete a customer record.
Endpointโ
DELETE /v1/customers/{id}
Authenticationโ
Requires an API key with the customers:write scope.
Parametersโ
| Parameter | Type | Location | Description |
|---|---|---|---|
id | integer | path | The customer ID |
Example Requestโ
curl -X DELETE "https://app.equipdash.com/api/v1/customers/256" \
-H "Authorization: Bearer eqd_live_abc123xyz789..."
Responseโ
Success (200 OK)โ
{
"data": {
"deleted": true
},
"meta": {
"request_id": "req_abc123",
"timestamp": "2026-01-15T12:00:00+00:00"
}
}
Errorsโ
| Status | Code | Description |
|---|---|---|
| 401 | authentication_required | No API key provided |
| 401 | invalid_api_key | Invalid API key |
| 403 | insufficient_scope | API key lacks customers:write scope |
| 403 | forbidden | Customer belongs to different supplier |
| 404 | resource_not_found | Customer does not exist |
Notesโ
- Deleting a customer does not delete their historical bookings
- Deleted customer data is retained for audit purposes
- Consider updating the customer record instead of deleting if you need to preserve data