Skip to main content
DELETE
/
admin
/
customers
/
{customer_id}
Delete Customer
curl --request DELETE \
  --url https://api.example.com/admin/customers/{customer_id}
{
  "message": "Customer deleted successfully",
  "customer_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "cancelled"
}
Delete a customer account. This is a soft delete that disables the API key and sets the status to cancelled.
This action disables the customer’s API key immediately. The customer will no longer be able to access the API.

Path Parameters

customer_id
string
required
Customer UUID

Response

message
string
Confirmation message
customer_id
string
Deleted customer ID
status
string
New status: cancelled
{
  "message": "Customer deleted successfully",
  "customer_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "cancelled"
}

Example

curl -X DELETE "https://{admin-api-url}/admin/customers/550e8400-e29b-41d4-a716-446655440000" \
  -H "x-api-key: ADMIN_API_KEY"