---
title: "Create a zone"
method: POST
path: "/companies/zones"
tags: ["companies"]
---

# Create a zone

`POST /companies/zones`

Creates a new zone setting of the company
Requires the privilege [`TEST_SUITES_WRITE`](https://www.gremlin.com/docs/user-management/access-control/#privileges)

## Request body

- Zone — A zone setting for zonal tests
  - `zoneId` string — The name for the zone
  - `cidrs` string[], required — Extra CIDRs to use when running zone-based network experiments
  - `includeAllAgents` boolean, required — Determine if Gremlin agents across company should be used

## Response `default`

default response

## Other responses

- `401` — Authorization header missing or malformed. Please provide proper credentials in the authorization header.
- `403` — User requires privilege: TEST_SUITES_WRITE

---

[API](https://skmtc.net/gremlin/apis/gremlin-api.md) · [All operations](https://skmtc.net/gremlin/apis/gremlin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gremlin/gremlin-api/versions/70fe938a0b35/schema)