Retrieves all add-on management profiles.
get /bsp/api/v1/bmp/manage_addons
https://{serverurl}/bsp/api/v1/bmp/manage_addons Copied!
Authorization: Zoho-oauthtoken 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://appdomains/bsp/api/v1/bmp/manage_addons \
--header 'Accept: application/json' \
--header 'Authorization: Zoho-oauthtoken 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 returned when authentication credentials are missing, expired, or invalid (authentication=required)
Authentication failure reason
Forbidden error code returned when the authenticated user does not have the required uem-roles (e.g., DataEncryption_Admin or DataEncryptionRecoveryKey_Admin)
Message indicating insufficient privileges to access this resource
Rate limit error code returned when the API call threshold (configured via threshold/duration in security XML) is exceeded; client is locked out for lock-period minutes
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.