v22

latestOpenAPI 3.0.0raw.githubusercontent.com2026-07-01140308542.4 KB

Zones

Get zone

Returns details of a specific zone by ID

get/zones/{zoneId}

Path parameters

zoneIdstring required

Zone ID

Query parameters

'permissions'

string[]

Response

A zone for organizing resources within an organization

idstring required

Unique identifier of the zone

organization_idstring required

Organization that owns this zone

slugstring required

URL-safe identifier, unique within the zone

namestring required

Human-readable name

descriptionstring nullable

Human-readable description

user_identity_provider_idstring

Provider ID configured for user login

requires_invitationboolean

Whether the zone requires an invitation for email/password registration, only applies when user_identity_provider_id is not set

default_mcp_gateway_application_idstring

Application ID configured as the default MCP Gateway for the zone

default_resource_idstring

Resource ID configured as the default resource for the zone

permissionsIamPermissions

Permissions granted to the authenticated principal. Only populated when expand[]=permissions query parameter is provided. Keys are resource types, values are objects mapping action names to boolean values.

owner_type'platform' | 'customer' required

Who owns this zone. Platform-owned zones cannot be modified via API.

created_atstring date-time required

Entity creation timestamp

updated_atstring date-time required

Entity update timestamp

Example response

{
  "permissions": {
    "zones": {
      "read": true,
      "update": true,
      "delete": false,
      "create": false
    },
    "applications": {
      "read": true,
      "list": true,
      "create": false
    }
  }
}