PUT

/admin/api/2026-07/zones/{zone_id}.json

Update an existing zone's name, coverage, or status.

Try it

Parameters

zone_idinteger, requiredThe zone's numeric ID, as a path parameter.

zone.statusstring, optionalOne of `draft`, `published`, `archived`. Publishing requires at least one rule attached.

Error responses

404NOT_FOUNDNo zone exists with the given zone_id on this shop.

422PUBLISH_REQUIRES_RULECannot set status to published on a zone with zero rules attached.

Request body

{
  "zone": {
    "status": "published"
  }
}

Response 201

{
  "zone": {
    "status": "published"
  }
}

curl -X PUT "https://{shop}.myshopify.com/admin/api/2026-07/zones/918273645.json" \
  -H "X-Shopify-Access-Token: {access_token}" \
  -H "Content-Type: application/json" \
  -d '{"zone":{"status":"published"}}'

client.put(path: "zones/918273645", body: { zone: { status: "published" } })

await fetch(`https://${shop}/admin/api/2026-07/zones/918273645.json`, {
  method: 'PUT',
  headers: {
    'X-Shopify-Access-Token': accessToken,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ zone: { status: 'published' } }),
});