Skip to main content
DELETE
/
organizations
/
{organizationId}
/
customers
/
{customerId}
Delete a customer
curl --request DELETE \
  --url http://sandbox.mintlify.com/organizations/{organizationId}/customers/{customerId} \
  --header 'Authorization: Bearer <token>'
Permanently deletes a customer. This action cannot be undone.

Authentication

Requires a valid Bearer token. The authenticated user must be a member of the organization.

Path Parameters

ParameterTypeRequiredDescription
organizationIdstring (UUID)YesOrganization ID
customerIdstringYesCustomer ID

Example Request

curl -X DELETE http://localhost:3001/api/organizations/550e8400-e29b-41d4-a716-446655440000/customers/590ce6c56d04f840aa8438af \
  -H "Authorization: Bearer <your_token>"

Response

Returns 204 No Content on success with no response body.

Common Errors

401 Unauthorized

Authentication required.

403 Forbidden

User is not a member of this organization.

404 Not Found

Customer not found.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

organizationId
string
required
customerId
string
required

Response

204 - undefined