Retrieves all add-on management profiles.
get /bsp/api/v1/bmp/manage_addons
https://{server-hostname}:8383/bsp/api/v1/bmp/manage_addons Copied!
Authorization: d92d4xxxxxxxxxxxxx15f52
Optional. Set to true to return only published profiles
Optional. Maximum number of profiles to return per page. Used for pagination
Optional. Number of profiles to skip before starting to return results. Used for pagination
Optional. Token for pagination to retrieve the next set of results
Optional. Set to true to include trashed (deleted) profiles in results
curl --request GET \
--url 'https://appdomain/bsp/api/v1/bmp/manage_addons?published=SOME_BOOLEAN_VALUE&limit=SOME_INTEGER_VALUE&offset=SOME_INTEGER_VALUE&skip-token=SOME_STRING_VALUE&trash=SOME_BOOLEAN_VALUE' \
--header 'Accept: application/json' \
--header 'Authorization: d92d4xxxxxxxxxxxxx15f52'Add-on management profile summaries
Profile display name
Profile type identifier
Profile status. 110=Published, 1=Draft
Unique profile identifier
Profile display name
Profile type identifier
Profile status. 110=Published, 1=Draft
Unique profile identifier
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
Message describing the internal server error
List of profiles (summary only)
{
"manage_addons": [
{
"manage_addon_name": "AddonPolicy 13",
"profiletype": "64025",
"profilestatus": "1",
"manage_addon_id": "609"
},
{
"manage_addon_name": "AddonPolicy 12",
"profiletype": "64025",
"profilestatus": "1",
"manage_addon_id": "611"
},
{
"manage_addon_name": "TestAddon_Renamed",
"profiletype": "64025",
"profilestatus": "110",
"manage_addon_id": "993"
}
]
}
No profiles exist
{
"manage_addons": []
}
Unauthorized
{
"errorCode": "UNAUTHORIZED",
"errorMsg": "You are not authorized to perform this action"
}
Insufficient permissions
{
"errorCode": "FORBIDDEN",
"errorMsg": "User does not have permission to perform this operation"
}
Rate limit exceeded
{
"errorCode": "RATE_LIMIT_EXCEEDED",
"errorMsg": "Too many requests. Please try again after 5 minutes"
}
Server error
{
"errormsg": "Internal Server error, Please try again in a moment."
}
![]()
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.