Post locations — devices

This endpoint allows you to create a new location. Support for Location-based camera grouping is only available in the professional and enterprise editions.

Request body

idstring

namestring required

parentIdstring

Unique identifier of this location's parent location in the hierarchy

isDefaultboolean

Specifies if a new device should be automatically assigned to this location if not supplied

notesstring

Description for the location

childLocationCountinteger

The total count of direct children of the location

Example request

{
  "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "name": "CF2 - Austin Office",
  "parentId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "address": {
    "country": "USA",
    "region": "Texas",
    "city": "Austin",
    "streetAddress": "4611 Bee Caves Rd",
    "streetAddress2": "SUITE 102",
    "postalCode": "78746"
  },
  "geometry": {
    "type": "MultiPolygon",
    "coordinates": [
      [
        [
          [
            40,
            40
          ],
          [
            20,
            45
          ],
          [
            45,
            30
          ],
          [
            40,
            40
          ]
        ]
      ],
      [
        [
          [
            20,
            35
          ],
          [
            10,
            30
          ],
          [
            10,
            10
          ],
          [
            30,
            5
          ],
          [
            45,
            20
          ],
          [
            20,
            35
          ]
        ],
        [
          [
            30,
            20
          ],
          [
            20,
            15
          ],
          [
            20,
            25
          ],
          [
            30,
            20
          ]
        ]
      ]
    ],
    "bbox": [
      -10,
      -10,
      10,
      10
    ]
  },
  "resourceCounts": {
    "cameras": 23,
    "bridges": 2,
    "speakers": 1,
    "users": 12,
    "multiCameras": 3
  }
}

Response

Location created