(Quick Reference) Service: Delete a customer

Description: this web service is used in order to delete an existing customer

URL:

https://BASE_URL/api/VERSION/customers/{id}

URL with external_id:

https://BASE_URL/api/VERSION/customers/reference/{id}

Method: DELETE

Parameters:

NameDescriptionTypeRequiredExample values
idThe ID of the desired customerLong/Stringyes123

Success Output

Success case: response.status=200

{
  "success": "true",
  "success_description": "Instance deleted successfully"
}

Failure Output

Failure case:response.status = 400
{
  "error": "delete_failed",
  "error_description": "Failed to delete instance."
}
{
  "error":"invalid_param_type",
  "error_description": "The type of parameter id you provided is not valid for this request."
}

Failure case:response.status = 404
{
  "error": "not_found",
  "error_description": "The customer with the id 32987 doesn't exist."
}

Failure case:response.status = 500
{
  "error": "server_error",
  "error_description": "Oops! Something went wrong..."
}