Updates an add-on payload's add-ons, policies, and native messaging hosts. Published profiles cannot be updated.
https://{serverurl}/bsp/api/v1/bmp/manage_addons/{addon_id}/addon_payloads/{payload_id}
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Payload ID from Get Add-On Management Profile response (config_data_item_id field)
Add-On Management Profile ID from List Add-On Management Profiles response (manage_addon_id field)
JSON body with updated payload configuration data
curl --request PUT \
--url https://appdomains/bsp/api/v1/bmp/manage_addons/{addon_id}/addon_payloads/{payload_id} \
--header 'Accept: application/json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/json' \
--data '{}'Modify Chrome payload
{
"addon_payloads": {
"restrict_permissions": 1,
"payload_type": 64125,
"runtime_addons": [],
"restrict_domains": -1,
"pinned_addons": [
"30"
],
"permissions": [
"10"
],
"browser_type": 1,
"policies": {
"disable_user_extensions": "-1"
},
"add_ons": [
{
"binary_id": "30"
}
],
"restrict_addons": "1",
"native_hosts": {
"native_permission": "-1",
"native_ids": []
},
"install_addons": [
"30"
]
}
}
curl --request PUT \
--url https://appdomains/bsp/api/v1/bmp/manage_addons/{addon_id}/addon_payloads/{payload_id} \
--header 'Accept: application/json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/json' \
--data '{}'Modify Firefox payload
{
"addon_payloads": {
"payload_type": 64127,
"restrict_domains": -1,
"browser_type": 2,
"policies": {
"disable_user_extensions": "-1"
},
"add_ons": [
{
"binary_id": "13"
}
],
"restrict_addons": "1",
"install_addons": []
}
}
curl --request PUT \
--url https://appdomains/bsp/api/v1/bmp/manage_addons/{addon_id}/addon_payloads/{payload_id} \
--header 'Accept: application/json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/json' \
--data '{}'Modify Edge payload
{
"addon_payloads": {
"restrict_permissions": 1,
"payload_type": 64907,
"runtime_addons": [],
"restrict_domains": -1,
"pinned_addons": [],
"permissions": [],
"browser_type": 5,
"policies": {
"disable_user_extensions": "-1"
},
"add_ons": [],
"restrict_addons": "1",
"native_hosts": {
"native_permission": "-1",
"native_ids": []
},
"install_addons": []
}
}
curl --request PUT \
--url https://appdomains/bsp/api/v1/bmp/manage_addons/{addon_id}/addon_payloads/{payload_id} \
--header 'Accept: application/json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/json' \
--data '{}'Modify Ulaa payload
{
"addon_payloads": {
"restrict_permissions": 1,
"payload_type": 64459,
"runtime_addons": [],
"restrict_domains": -1,
"pinned_addons": [
"30"
],
"permissions": [],
"browser_type": 31,
"policies": {
"disable_user_extensions": "-1"
},
"add_ons": [
{
"binary_id": "30"
}
],
"restrict_addons": "1",
"native_hosts": {
"native_permission": "-1",
"native_ids": []
}
}
}
curl --request PUT \
--url https://appdomains/bsp/api/v1/bmp/manage_addons/{addon_id}/addon_payloads/{payload_id} \
--header 'Accept: application/json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/json' \
--data '{}'Modify Chromium payload
{
"addon_payloads": {
"restrict_permissions": 1,
"payload_type": 64409,
"runtime_addons": [],
"restrict_domains": -1,
"pinned_addons": [],
"permissions": [],
"browser_type": 1024,
"policies": {
"disable_user_extensions": "-1"
},
"add_ons": [],
"restrict_addons": "1",
"native_hosts": {
"native_permission": "-1",
"native_ids": []
}
}
}
curl --request PUT \
--url https://appdomains/bsp/api/v1/bmp/manage_addons/{addon_id}/addon_payloads/{payload_id} \
--header 'Accept: application/json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/json' \
--data '{}'Modify IE payload
{
"addon_payloads": {
"restrict_permissions": -1,
"payload_type": 64126,
"restrict_domains": -1,
"permissions": [],
"browser_type": 3,
"policies": {
"turn_off_blocking_outdated_addon": "1",
"restrict_activex": "0",
"remove_run_this_time": "0",
"enable_extensions": "1"
},
"add_ons": [],
"restrict_addons": "0"
}
}
Unauthorized error code: credentials missing, expired, or invalid
Authentication failure reason
Error code indicating insufficient permissions
Message indicating insufficient privileges to access this resource
Message indicating the requested resource was not found
Message indicating a published profile cannot be modified
Rate limit error code returned when the API call reached threshold
Rate limit exceeded message with retry guidance
Message describing the internal server error
Chrome payload modified
{
"payloads": [
{
"restrict_permissions": "1",
"payload_type": "64125",
"restrict_domains": "-1",
"binaries_details": [
{
"browser_type": "1",
"name": "Google Translate",
"binary_id": "30",
"id": "aapbdbdomjkkjkaonfhkkikfgjllcleb"
}
],
"payload_id": "1164",
"permissions": [
{
"name": "Context menu",
"id": "10"
}
],
"pinned_binaries_details": [
{
"browser_type": "1",
"name": "Google Translate",
"binary_id": "30",
"id": "aapbdbdomjkkjkaonfhkkikfgjllcleb"
}
],
"browser_type": "1",
"policies": {
"disable_user_extensions": "1",
"allow_flash": "-1"
},
"restrict_addons": "1",
"native_hosts": {
"native_permission": "-1",
"native_details": []
},
"config_label": "MANAGE_CHROME_ADDONS"
}
]
}
Firefox payload modified
{
"payloads": [
{
"payload_type": "64127",
"restrict_domains": "-1",
"binaries_details": [
{
"browser_type": "2",
"name": "System theme — auto",
"binary_id": "13",
"id": "default-theme@mozilla.org"
}
],
"payload_id": "1171",
"pinned_binaries_details": [],
"browser_type": "2",
"policies": {
"disable_user_extensions": "1"
},
"restrict_addons": "1",
"config_label": "MANAGE_FIREFOX_ADDONS"
}
]
}
Edge payload modified
{
"payloads": [
{
"restrict_permissions": "1",
"payload_type": "64907",
"restrict_domains": "-1",
"binaries_details": [],
"payload_id": "1172",
"permissions": [
{
"name": "Context menu",
"id": "10"
}
],
"pinned_binaries_details": [],
"browser_type": "5",
"policies": {
"disable_user_extensions": "1",
"allow_flash": "-1"
},
"restrict_addons": "1",
"native_hosts": {
"native_permission": "-1",
"native_details": []
},
"config_label": "CHROMIUM_EDGE_ADDONS_PAYLOAD"
}
]
}
Ulaa payload modified
{
"payloads": [
{
"restrict_permissions": "1",
"payload_type": "64459",
"restrict_domains": "-1",
"binaries_details": [
{
"browser_type": "1",
"name": "Google Translate",
"binary_id": "30",
"id": "aapbdbdomjkkjkaonfhkkikfgjllcleb"
}
],
"payload_id": "1173",
"permissions": [
{
"name": "Context menu",
"id": "10"
}
],
"pinned_binaries_details": [
{
"browser_type": "1",
"name": "Google Translate",
"binary_id": "30",
"id": "aapbdbdomjkkjkaonfhkkikfgjllcleb"
}
],
"browser_type": "31",
"policies": {
"disable_user_extensions": "1",
"allow_flash": "-1"
},
"restrict_addons": "1",
"native_hosts": {
"native_permission": "-1",
"native_details": []
},
"config_label": "MANAGE_ULAA_ADDONS"
}
]
}
Chromium payload modified
{
"payloads": [
{
"restrict_permissions": "1",
"payload_type": "64409",
"restrict_domains": "-1",
"payload_id": "1174",
"browser_type": "1024",
"policies": {
"disable_user_extensions": "1",
"allow_flash": "-1"
},
"applicable_browsers": [],
"binaries_details": [
{
"browser_type": "1",
"name": "Google Translate",
"binary_id": "30",
"id": "aapbdbdomjkkjkaonfhkkikfgjllcleb"
}
],
"permissions": [
{
"name": "Context menu",
"id": "10"
}
],
"pinned_binaries_details": [
{
"browser_type": "1",
"name": "Google Translate",
"binary_id": "30",
"id": "aapbdbdomjkkjkaonfhkkikfgjllcleb"
}
],
"restrict_addons": "1",
"native_hosts": {
"native_permission": "-1",
"native_details": []
},
"config_label": "CHROMIUM_ADDONS_PAYLOAD"
}
]
}
IE payload modified
{
"payloads": [
{
"payload_type": "64126",
"restrict_domains": "-1",
"binaries_details": [],
"payload_id": "1175",
"pinned_binaries_details": [],
"browser_type": "3",
"policies": {
"turn_off_blocking_outdated_addon": "1",
"enable_extension": "1",
"restrict_activex": "0",
"remove_run_this_time": "0"
},
"restrict_addons": "0",
"config_label": "MANAGE_IE_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"
}
Profile or payload not found
{
"errormsg": "Payload not found"
}
Cannot modify published profile
{
"errormsg": "Cannot modify published policy. Clone the policy and retry"
}
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.