Deletes a specific payload configuration from a profile. Removes the browser policy settings associated with the payload. The profile itself is not deleted.
https://{serverurl}/bsp/api/v1/bmp/profiles/{profile_id}/payloads/{payload_id}
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Payload ID obtained from Add Payload API response or from Get Profile payloads array
Retrieve the configuration profile ID from the profileid key in the response returned by List Configuration Profiles
curl --request DELETE \
--url https://appdomains/bsp/api/v1/bmp/profiles/{profile_id}/payloads/{payload_id} \
--header 'Accept: application/json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52'Unauthorized error code: credentials missing, expired, or invalid
Authentication failure reason
Error code indicating insufficient permissions
Message indicating insufficient privileges to access this resource
Rate limit error code returned when the API call reached threshold
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
Returns 204 No Content on success.
204 Returns 204 No Content on success.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 does not exist
{
"errormsg": "Profile not found"
}
Payload does not exist or already deleted
{
"errormsg": "Payload not found"
}
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.