PUT /api/v1/zones/{zoneId}
Replaces a Network Zone by zoneId. The replaced Network Zone type must be the same as the existing type.
You can replace the usage (POLICY, BLOCKLIST) of a Network Zone by updating the usage attribute.
IP exempt zone
If you have the IP exempt zone feature enabled, you can allow traffic from specific gateway IPs irrespective of Okta ThreatInsight configurations, blocked network zones, or IP change events within Identity Threat Protection with Okta AI.
When you enable this feature, Okta creates a zone called DefaultExemptIpZone. Gateway IPs that you add to this zone always have access to Okta resources. See IP exempt zone.
Note: You can't add trusted proxy IPs to this zone, delete the zone, or create additional exempt IP zones.
Servers
- https://{yourOktaDomain}
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
zoneId |
String | Yes |
|
Request headers
| Name | Type | Required | Description |
|---|---|---|---|
Content-Type |
String | Yes |
The media type of the request body.
Default value: "application/json" |
Request body fields
| Name | Type | Required | Description |
|---|---|---|---|
id |
String | No |
Unique identifier for the Network Zone |
usage |
String | No |
The usage of the Network Zone Valid values:
|
created |
String | No |
Timestamp when the object was created |
name |
String | Yes |
Unique name for this Network Zone |
system |
Boolean | No |
Indicates a system Network Zone:
The Okta org provides the following default system Network Zones:
Admins can modify the name of the default system Network Zone and add up to 5000 gateway or proxy IP entries. |
type |
String | Yes |
The type of Network Zone Valid values:
|
status |
String | No |
Network Zone status Valid values:
|
lastUpdated |
String | No |
Timestamp when the object was last modified |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.