Skip to main content
GET
Get point priority array
A writable point on a building automation system can hold a value at several priority levels. The lowest level number has the highest priority. To see which level is in effect, use Get point write state. KODE OS reads the levels from the data source on each request, so the response reflects the point now. A slow or unreachable data source makes the request slow or makes it fail. The response lists only the levels the data source reports, lowest level first. A level that is not listed holds no value. The level range depends on the connector, for example 0 to 15 or 1 to 16. The response is 200 with an empty array when:
  • The point is not writable.
  • The point’s connector cannot write to points, or has been deleted.
  • The connector does not keep a priority array for the point.
  • No level holds a value.
This endpoint only reads. It does not write a value or release a level.

Authorizations

Authorization
string
header
required

Paste an access token from Create an access token. Tokens expire, so request a new one if you receive 401.

Path Parameters

buildingId
string
required

Building identifier from List buildings.

pointId
string
required

Point identifier.

Response

The priority levels that hold a value, lowest level first.

level
integer<int32>

Priority level. The lowest number has the highest priority.

Example:

8

value
string | null

Value held at this level, as the data source reports it.

Example:

"72"

who
string | null

Who set the value at this level, as the data source reports it.

Example:

"KODE OS"