Permanently deletes a configuration profile. The profile must be moved to trash before it can be deleted.
delete /bsp/api/v1/bmp/profiles/{profile_id}
https://{server-hostname}:8383/bsp/api/v1/bmp/profiles/{profile_id} Copied!
Authorization: d92d4xxxxxxxxxxxxx15f52
Retrieve the configuration profile ID from the profileid key in the response returned by List Configuration Profiles
curl --request DELETE \
--url https://appdomain/bsp/api/v1/bmp/profiles/{profile_id} \
--header 'Accept: application/json' \
--header 'Authorization: d92d4xxxxxxxxxxxxx15f52'Bad request error for invalid input or constraint violations
Error code identifying the specific validation failure
Message describing the validation failure
Unauthorized error code: API key or OAuth token missing, expired or invalid
Authentication failure reason
Forbidden error code: the user lacks the required MDM_OSUpdateMgmt UEM role
Message indicating insufficient privileges
Precondition failure indicating the profile has active device associations preventing deletion
Error code identifying the precondition failure
Message indicating the profile has active device associations preventing deletion
Rate limit error code: API call threshold exceeded for this endpoint group
Rate limit exceeded message with retry guidance
Internal server error response for profile operations
Error message describing the server failure
Error code for internal server errors
204 Returns 204 No Content on success.Attempt to delete protected profile type 64501 or 64502
{
"errorcode": "IAM0003",
"errormsg": "Invalid request."
}
API key is missing or invalid
{
"errorCode": "IAM0001",
"errorMsg": "Authentication key is invalid. Please regenerate the key and try again."
}
Forbidden
{
"errorCode": "FORBIDDEN",
"errorMsg": "User does not have permission to perform this operation"
}
Profile still has devices associated. Disassociate all devices from the profile before deleting.
{
"errorcode": "IAM0007",
"errormsg": "The following pre-requisites to complete this request were not found: Profile(s) are not safe to be deleted"
}
Rate limit exceeded
{
"errorCode": "RATE_LIMIT_EXCEEDED",
"errorMsg": "Too many requests. Please try again after 5 minutes"
}
Server error
{
"error_description": "Internal Server error, Please try again in a moment.",
"error_code": "COM0004"
}
![]()
Duration: 1 minute | Threshold: 60 | Lock period: 5 minutes
Duration - Time window for the threshold.
Threshold - Number of API calls allowed within the specified duration.
Lock Period - Wait time before consecutive API requests.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.