HomeGuidesAPI Reference
API Reference

Save Zscaler location and sub-location configurations

Replaces all Zscaler location configurations with the provided array. Validates appliances, groups, regions, WAN labels, LAN labels, and firewall zones exist; removes invalid references silently. Converts bandwidth from Kbps to Mbps (multiplied by 1000) for storage unless bwControl is 'usePercent'. Converts time values to minutes based on displayTimeUnit/surrogateRefreshTimeUnit. Gateway options have dependencies: authRequired=true disables aupEnabled/cautionEnabled but enables surrogateIP/kerberosAuth; ofwEnabled=false disables ipsControl; aupEnabled=false resets aupTimeoutInDays; surrogateIP=false disables surrogateIPEnforcedForKnownBrowsers and resets idleTimeInMinutes. After save, triggers orchestration for all appliances.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Array of Zscaler location configurations. The entire configuration set is replaced. IDs are auto-reassigned sequentially (1, 2, 3...) to maintain database order. Bandwidth in Kbps is converted to Mbps for storage (except usePercent mode). Time values converted based on their unit fields. Invalid appliances/groups/regions/labels/zones are silently removed during validation.

Responses
204

No Content - Configuration saved successfully. All appliances added to pending orchestration list.

401

Unauthorized - Valid session cookie required

403

Forbidden - READ_WRITE permission required

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
text/plain