Get browser settings on a device

Open in ChatGPT Open in ChatGPT to ask questions about this page
Open in Claude Open in Claude to ask questions about this page
Copy as MarkdownCopy this page as markdown to use with AI assistants
View as Markdown Open this page as markdown in a new tab

Returns content and privacy restriction settings for a browser on a device.

Request URL

https://{serverurl}/bsp/api/v1/bmp/devices/{device_id}/browsers/{browser_id}/settings

Scope

DesktopCentralCloud.BrowserManager.READCopied!

Header

Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

Request Parameters

- Request Headers

AcceptstringMandatory
application/jsonapplication/jsonCopied!

- Path Parameters

browser_idstringMandatory

Browser type ID from List Browsers response (browser_type field)

device_idstringMandatory

Device resource ID from List Devices response (device_id field)

Sample Request

Curl
Java
Python
Deluge
PowerShell
Copied!
curl --request GET \
  --url https://appdomains/bsp/api/v1/bmp/devices/{device_id}/browsers/{browser_id}/settings \
  --header 'Accept: application/json' \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52'

Response Parameters

- HTTP code 200

Response Body - application/json
JSON Object

Device browser content and privacy settings

Hide Sub-Attributes
invchromecontentrestrictJSON Object

Browser content restriction settings

Show Sub-Attributes
managed_resource_idstring

Device resource ID

javascript_settingstring

JavaScript execution setting

images_settingstring

Image loading setting

audio_capture_allowedstring

Audio capture permission

geolocation_settingstring

Geolocation access permission

cookies_settingstring

Cookie storage setting

video_capture_allowedstring

Video capture permission

auto_prompting_for_file_downloadsstring

Automatic file download prompting

notifications_settingstring

Browser notification permission

popups_settingstring

Popup window setting

managed_browser_idstring

Browser type ID

invchromeprivacyrestrictJSON Object

Browser privacy restriction settings

Show Sub-Attributes
managed_resource_idstring

Device resource ID

referrers_enabledstring

HTTP referrer header sending

safe_browsing_enabledstring

Google Safe Browsing protection

search_suggest_enabledstring

Search suggestion service

autofill_creditcard_enablestring

Credit card autofill

managed_browser_idstring

Browser type ID

autofill_address_enablestring

Address autofill

alternate_error_pages_enabledstring

Alternate error pages

translation_service_enabledstring

Built-in translation service

spelling_service_enabledstring

Spelling correction service

password_saving_enabledstring

Password manager save prompt

safe_browsing_extd_rpting_enabledstring

Safe Browsing extended reporting

managed_passwordstring

Managed password policy

third_party_cookiesstring

Third-party cookie acceptance

hyperlink_auditing_enabledstring

Hyperlink auditing

- HTTP code 401

Response Body - application/json
JSON Object
Hide Sub-Attributes
errorCodelong

Unauthorized error code: credentials missing, expired, or invalid

errorMsgstring

Authentication failure reason

- HTTP code 403

Response Body - application/json
JSON Object
Hide Sub-Attributes
errorCodelong

Error code indicating insufficient permissions

errorMsgstring

Message indicating insufficient privileges to access this resource

- HTTP code 429

Response Body - application/json
JSON Object
Hide Sub-Attributes
errorCodelong

Rate limit error code returned when the API call reached threshold

errorMsgstring

Rate limit exceeded message with retry guidance

- HTTP code 500

Response Body - application/json
JSON Object

Internal server error during device operations

Hide Sub-Attributes
error_descriptionstring

Message describing the server-side failure

error_codestring

Internal server error code

Possible Response Codes

200HTTP code
401HTTP code
403HTTP code
429HTTP code
500HTTP code

Sample Response: HTTP 200

Browser settings

Copied!
  {
    "invchromecontentrestrict": {
      "managed_resource_id": "311",
      "javascript_setting": "enabled",
      "images_setting": "enabled",
      "audio_capture_allowed": "prompt",
      "geolocation_setting": "prompt",
      "cookies_setting": "enabled",
      "video_capture_allowed": "prompt",
      "auto_prompting_for_file_downloads": "prompt",
      "notifications_setting": "prompt",
      "popups_setting": "disabled",
      "managed_browser_id": "1"
    },
    "invchromeprivacyrestrict": {
      "managed_resource_id": "311",
      "referrers_enabled": "enabled",
      "safe_browsing_enabled": "enabled",
      "search_suggest_enabled": "enabled",
      "autofill_creditcard_enable": "enabled",
      "managed_browser_id": "1",
      "autofill_address_enable": "enabled",
      "alternate_error_pages_enabled": "enabled",
      "translation_service_enabled": "enabled",
      "spelling_service_enabled": "disabled",
      "password_saving_enabled": "enabled",
      "safe_browsing_extd_rpting_enabled": "disabled",
      "managed_password": "enabled",
      "third_party_cookies": "enabled",
      "hyperlink_auditing_enabled": "enabled"
    }
  }
                
Show full

Sample Response: HTTP 401

Unauthorized

Copied!
  {
    "errorCode": "UNAUTHORIZED",
    "errorMsg": "You are not authorized to perform this action"
  }
                
Show full

Sample Response: HTTP 403

Forbidden

Copied!
  {
    "errorCode": "FORBIDDEN",
    "errorMsg": "You do not have permission to access this resource"
  }
                
Show full

Sample Response: HTTP 429

Rate limit exceeded

Copied!
  {
    "errorCode": "RATE_LIMIT_EXCEEDED",
    "errorMsg": "You have exceeded the maximum number of API calls. Please try again later."
  }
                
Show full

Sample Response: HTTP 500

Server error

Copied!
  {
    "error_description": "Internal Server error, Please try again in a moment.",
    "error_code": "COM0004"
  }
                
Show full

Device not found

Copied!
  {
    "errorCode": "RESOURCE0001",
    "errorMsg": "No computers are found."
  }
                
Show full

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.