Skip to main content
POST
/
api
/
occupancy
/
updateDetails
Update occupancy sensor details
curl --request POST \
  --url https://api2.rhombussystems.com/api/occupancy/updateDetails \
  --header 'Content-Type: application/json' \
  --header 'x-auth-apikey: <api-key>' \
  --header 'x-auth-scheme: <x-auth-scheme>' \
  --data '
{
  "associatedCameras": [
    "AAAAAAAAAAAAAAAAAAAAAA.v0"
  ],
  "associatedCamerasUpdated": false,
  "deleted": false,
  "deletedUpdated": false,
  "description": "Motion sensor for conference room A",
  "descriptionUpdated": false,
  "floorNumber": 2,
  "floorNumberUpdated": false,
  "latitude": 37.7749,
  "latitudeUpdated": false,
  "locationUuid": "AAAAAAAAAAAAAAAAAAAAAA",
  "locationUuidUpdated": false,
  "longitude": -122.4194,
  "longitudeUpdated": false,
  "name": "Conference Room Sensor",
  "nameUpdated": false,
  "policyUuid": "AAAAAAAAAAAAAAAAAAAAAA",
  "policyUuidUpdated": false,
  "subLocationsHierarchyKey": "AAAAAAAAAAAAAAAAAAAAAA.AAAAAAAAAAAAAAAAAAAAAA.AAAAAAAAAAAAAAAAAAAAAA",
  "subLocationsHierarchyKeyUpdated": false,
  "uuid": "AAAAAAAAAAAAAAAAAAAAAA"
}
'
{
  "error": true,
  "errorMsg": "<string>",
  "warningMsg": "<string>"
}

Authorizations

x-auth-apikey
string
header
required

Your API key for Rhombus.

Headers

x-auth-scheme
string
default:api-token
required

Authentication scheme indicator ("api-token").

Required string length: 9

Body

application/json

Request object for updating occupancy sensor details with selective update flags.

associatedCameras
(string<DeviceFacetUuid> | null)[] | null

List of associated camera device facet UUIDs

RUUID with optional appended facet information

Example:

"AAAAAAAAAAAAAAAAAAAAAA.v0"

associatedCamerasUpdated
boolean | null

Whether the associated cameras should be updated

Example:

false

deleted
boolean | null

Whether the sensor is marked as deleted

Example:

false

deletedUpdated
boolean | null

Whether the deleted status should be updated

Example:

false

description
string | null

Description of the occupancy sensor

Example:

"Motion sensor for conference room A"

descriptionUpdated
boolean | null

Whether the description should be updated

Example:

false

floorNumber
integer<int32> | null

Floor number where the sensor is located

Example:

2

floorNumberUpdated
boolean | null

Whether the floor number should be updated

Example:

false

latitude
number<double> | null

Latitude coordinate of the sensor location

Example:

37.7749

latitudeUpdated
boolean | null

Whether the latitude should be updated

Example:

false

locationUuid
string<RUUID> | null

base 64 (url-safe) uuid string

Example:

"AAAAAAAAAAAAAAAAAAAAAA"

locationUuidUpdated
boolean | null

Whether the location UUID should be updated

Example:

false

longitude
number<double> | null

Longitude coordinate of the sensor location

Example:

-122.4194

longitudeUpdated
boolean | null

Whether the longitude should be updated

Example:

false

name
string | null

Name of the occupancy sensor

Example:

"Conference Room Sensor"

nameUpdated
boolean | null

Whether the name should be updated

Example:

false

policyUuid
string<RUUID> | null

base 64 (url-safe) uuid string

Example:

"AAAAAAAAAAAAAAAAAAAAAA"

policyUuidUpdated
boolean | null

Whether the policy UUID should be updated

Example:

false

subLocationsHierarchyKey
object

A sequence of one or more base 64 (url-safe) uuid substrings. These substrings are separated by dots (.).

Example:

"AAAAAAAAAAAAAAAAAAAAAA.AAAAAAAAAAAAAAAAAAAAAA.AAAAAAAAAAAAAAAAAAAAAA"

subLocationsHierarchyKeyUpdated
boolean | null

Whether the sub-locations hierarchy key should be updated

Example:

false

uuid
string<RUUID> | null

base 64 (url-safe) uuid string

Example:

"AAAAAAAAAAAAAAAAAAAAAA"

Response

200 - application/json

OK

Response object for updating occupancy sensor details.

error
boolean | null
errorMsg
string | null
warningMsg
string | null