{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/johnson-controls/json-schema/johnson-controls-spaces-schema.json",
  "title": "spaces",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/johnson-controls-spaces-api-openapi.yml#/components/schemas/spaces",
  "type": "object",
  "properties": {
    "total": {
      "type": "integer",
      "description": "The total number of items in the collection."
    },
    "items": {
      "type": "array",
      "description": "Collection of spaces.",
      "items": {
        "$ref": "#/$defs/schemas_space"
      }
    },
    "next": {
      "type": [
        "string",
        "null"
      ],
      "description": "A link to the next page of results.",
      "format": "uri"
    },
    "previous": {
      "type": [
        "string",
        "null"
      ],
      "description": "A link to the previous page of results.",
      "format": "uri"
    },
    "self": {
      "type": "string",
      "description": "A link to this space collection.",
      "format": "uri"
    }
  },
  "required": [
    "total",
    "items",
    "next",
    "previous",
    "self"
  ],
  "$defs": {
    "schemas_space": {
      "type": "object",
      "title": "Space",
      "properties": {
        "id": {
          "type": "string",
          "description": "The identifier of the space."
        },
        "name": {
          "type": "string",
          "description": "The name of the space."
        },
        "type": {
          "type": "string",
          "description": "The type of the space.\n\nThe values for this property come from the `spaceTypesEnumSet` enumeration.\nFind the definition of `spaceTypesEnumSet` at the relative URL of `/schemas/enums/spaceTypesEnumSet`.\n\n**See also:**\n* [Get enumeration](#operation/getEnumerationAsJsonSchema) for more information on retrieving an enumeration.",
          "x-metasysEnum": "spaceTypesEnumSet"
        },
        "self": {
          "type": "string",
          "description": "A link to the space.",
          "format": "uri"
        },
        "parentUrl": {
          "type": [
            "string",
            "null"
          ],
          "description": "A link to the parent space of the space. This value is null if the space is the root space.",
          "format": "uri"
        },
        "spacesUrl": {
          "type": "string",
          "description": "A link to the collection spaces that are children of the space.",
          "format": "uri"
        },
        "equipmentUrl": {
          "type": "string",
          "description": "A link to the collection of equipment serving this space.",
          "format": "uri"
        },
        "networkDevicesUrl": {
          "type": "string",
          "format": "uri",
          "description": "A link to the collection of network devices which host points defined on equipment serving this space."
        },
        "itemReference": {
          "type": "string",
          "description": "The fully qualified reference of the space."
        },
        "description": {
          "x-releases": {
            "implementedAt": "15.0"
          },
          "type": "string",
          "description": "<span style=\"color: #92989b; font-size: 13px\">RELEASES</span>:<span style=\"color: #186faf;\"> <strong>15.0 and later</strong></span>\\\nThe description of the space."
        },
        "area": {
          "x-releases": {
            "implementedAt": "15.0"
          },
          "type": [
            "integer",
            "null"
          ],
          "description": "<span style=\"color: #92989b; font-size: 13px\">RELEASES</span>:<span style=\"color: #186faf;\"> <strong>15.0 and later</strong></span>\\\nThe area of the space as measured in square meters.\n"
        },
        "areaUnits": {
          "x-releases": {
            "implementedAt": "15.0"
          },
          "type": [
            "string",
            "null"
          ],
          "description": "<span style=\"color: #92989b; font-size: 13px\">RELEASES</span>:<span style=\"color: #186faf;\"> <strong>15.0 and later</strong></span>\\\nThe units of the area.\n\nThe values for this property come from the `areaUnitEnumSet` enumeration.\nFind the definition of `areaUnitEnumSet` at the relative URL of `/schemas/enums/areaUnitEnumSet`.\n\n**See also:**\n* [Get enumeration](#operation/getEnumerationAsJsonSchema) for more information on retrieving an enumeration.",
          "x-metasysEnum": "areaUnitEnumSet"
        }
      },
      "required": [
        "id",
        "itemReference",
        "name",
        "type",
        "self",
        "parentUrl",
        "spacesUrl",
        "equipmentUrl",
        "networkDevicesUrl"
      ]
    }
  }
}