Retrieves the list of devices and groups excluded from a profile's distribution target. Returns excluded device IDs/names and excluded group IDs/names/types.
https://{server-hostname}:8383/bsp/api/v1/bmp/profiles/{profile_id}/targets/exclude Copied!
Authorization: d92d4xxxxxxxxxxxxx15f52
Retrieve the configuration profile ID from the profileid key in the response returned by List Configuration Profiles
curl --request GET \
--url https://appdomain/bsp/api/v1/bmp/profiles/{profile_id}/targets/exclude \
--header 'Accept: application/json' \
--header 'Authorization: d92d4xxxxxxxxxxxxx15f52'Response containing excluded devices and groups for a profile's distribution target
Devices that are explicitly excluded from receiving this profile
Excluded device entry
Device resource ID
Device name
Device resource ID
Device name
Device groups that are explicitly excluded from receiving this profile
Excluded group entry
Group resource ID
Group name
Group type. 1=Static, 7=Dynamic
Group resource ID
Group name
Group type. 1=Static, 7=Dynamic
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
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
Profile with excluded devices and groups
{
"excluded_groups": [
{
"name": "Test Lab Machines",
"id": 401,
"type": 1
},
{
"name": "Kiosk Devices",
"id": 402,
"type": 7
}
],
"excluded_devices": [
{
"name": "DESKTOP-MARKETING-01",
"id": 301
},
{
"name": "LAPTOP-HR-05",
"id": 302
}
]
}
Profile with no exclusions configured
{
"excluded_groups": [],
"excluded_devices": []
}
Unauthorized
{
"errorCode": "UNAUTHORIZED",
"errorMsg": "You are not authorized to perform this action"
}
Forbidden
{
"errorCode": "FORBIDDEN",
"errorMsg": "You do not have permission to access this resource"
}
Rate limit exceeded
{
"errorCode": "RATE_LIMIT_EXCEEDED",
"errorMsg": "You have exceeded the maximum number of API calls. Please try again later."
}
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.