Zone

Zones group services and each service can be part of multiple zones.

List zones

List all available zones

GEThttps://192.168.1.0/clip/v2/resource/zone

Authorization

HueApplicationKey

Response

200401403404405406409429500503507

Zone Success Response

Body

application/json

errorsarray of Error (object)

dataarray of object

dataarray of RoomGet (object)

Request

JavaScriptCurl

const response = await fetch('https://192.168.1.0/clip/v2/resource/zone', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "errors": [
    {
      "description": "text"
    }
  ],
  "data": [
    {
      "type": "light",
      "id": "3883f8bf-30a3-445b-ac06-b047d50599df",
      "id_v1": "/lights/8",
      "children": [
        {
          "rid": "42edd1f5-9538-4180-9ced-2d9e07f26d0f",
          "rtype": "device"
        }
      ],
      "services": [
        {
          "rid": "42edd1f5-9538-4180-9ced-2d9e07f26d0f",
          "rtype": "device"
        }
      ],
      "metadata": {
        "name": "text",
        "archetype": "living_room"
      }
    }
  ]
}

Create zone

Create a new zone

POSThttps://192.168.1.0/clip/v2/resource/zone

Authorization

HueApplicationKey

Body

application/json

typestring

Type of the supported resources (always room here)

childrenarray of ResourceIdentifier (object)

Child devices/services to group by the derived group

metadataobject

configuration object for a room

Response

200401403404405406409429500503507

Success

Body

application/json

errorsarray of Error (object)

dataarray of object

dataarray of ResourceIdentifier (object)

Request

JavaScriptCurl

const response = await fetch('https://192.168.1.0/clip/v2/resource/zone', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "children": [
        {
          "rid": "00afc7d2-bae5-4613-8cd8-5ba0d064a572",
          "rtype": "light"
        }
      ],
      "metadata": {
        "name": "TV Zone",
        "archetype": "tv"
      }
    }),
});
const data = await response.json();

Response

{
  "errors": [
    {
      "description": "text"
    }
  ],
  "data": [
    {
      "rid": "42edd1f5-9538-4180-9ced-2d9e07f26d0f",
      "rtype": "device"
    }
  ]
}

Get Zone.

Get details of a single Zone from its given {zoneId}

GEThttps://192.168.1.0/clip/v2/resource/zone/{zoneId}

Authorization

HueApplicationKey

Path parameters

zoneId*string

ID of the Zone

Response

200401403404405406409429500503507

Zone Success Response

Body

application/json

errorsarray of Error (object)

dataarray of object

dataarray of RoomGet (object)

Request

JavaScriptCurl

const response = await fetch('https://192.168.1.0/clip/v2/resource/zone/{zoneId}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "errors": [
    {
      "description": "text"
    }
  ],
  "data": [
    {
      "type": "light",
      "id": "3883f8bf-30a3-445b-ac06-b047d50599df",
      "id_v1": "/lights/8",
      "children": [
        {
          "rid": "42edd1f5-9538-4180-9ced-2d9e07f26d0f",
          "rtype": "device"
        }
      ],
      "services": [
        {
          "rid": "42edd1f5-9538-4180-9ced-2d9e07f26d0f",
          "rtype": "device"
        }
      ],
      "metadata": {
        "name": "text",
        "archetype": "living_room"
      }
    }
  ]
}

Update Zone

Update a single Zone from its given {zoneId}

PUThttps://192.168.1.0/clip/v2/resource/zone/{zoneId}

Authorization

HueApplicationKey

Path parameters

zoneId*string

ID of the Zone

Body

application/json

typestring

Type of the supported resources (always room here)

childrenarray of ResourceIdentifier (object)

Child devices/services to group by the derived group

metadataobject

configuration object for a room

Response

200401403404405406409429500503507

Success

Body

application/json

errorsarray of Error (object)

dataarray of object

dataarray of ResourceIdentifier (object)

Request

JavaScriptCurl

const response = await fetch('https://192.168.1.0/clip/v2/resource/zone/{zoneId}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

{
  "errors": [
    {
      "description": "text"
    }
  ],
  "data": [
    {
      "rid": "42edd1f5-9538-4180-9ced-2d9e07f26d0f",
      "rtype": "device"
    }
  ]
}

Delete Zone

Delete a single Zone from its given {zoneId}

DELETEhttps://192.168.1.0/clip/v2/resource/zone/{zoneId}

Authorization

HueApplicationKey

Path parameters

zoneId*string

ID of the Zone

Response

200401403404405406409429500503507

Success

Body

application/json

errorsarray of Error (object)

dataarray of object

dataarray of ResourceIdentifier (object)

Request

JavaScriptCurl

const response = await fetch('https://192.168.1.0/clip/v2/resource/zone/{zoneId}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

{
  "errors": [
    {
      "description": "text"
    }
  ],
  "data": [
    {
      "rid": "42edd1f5-9538-4180-9ced-2d9e07f26d0f",
      "rtype": "device"
    }
  ]
}