Method Not Allowed

Updating a device location observation is not allowed. This call will return 405 Method Not Allowed.

Path Params
string
required

The ID that specifies a device location observation

Body Params
string

Read only system id.

string

Read only time that the record was created in the system.

string

Read only time that the record was created in the system. Device location observations cannot be updated, so this will always be equal to created_at.

string
required

The system id of the device. When creating a device location observation, you may set this to either the system id or the device's unique id. If you use the device's unique id you must also specify the device's company in the company_id field so that the system can uniquely identify the device. After creation, device_id will always contain the device's system id.

string

The company that the device location observations related device belongs to. When creating a device location observation through the API you may specify the company id of the device if using the device's unique_id in the device location observation's device_id field. After successful creation this will always equal the associated device's company_id

string

For convenience and filtering this will contain the associated device's unique_id

string

Id of the user that created the object, if any

string
required

The latitude of the observation. After creation this will continue to be the string value initially set during creation. This must parse to a valid float64 WSG84 latitude, between the bounds of -90.0 and 90.0.

string
required

The longitude of the observation. After creation this will continue to be the string value initially set during creation. This must parse to a valid float64 WSG84 longitude, between the bounds of -180.0 and 180.0.

string
required

A value indicating how accurate the observation is. This, in conjunction with latitude and longitude describe a point/radius region somewhere on the earth indicating the area where the device was location at the time the observation was taken. This value must be a number greater than zero. It will always be interpreted as meters by the system.

string

An optional convenience field to keep track of how the location was obtained. Valid values are api, gps, cell_tower, bluetooth, wifi, other, and unknown. If unset during creation and created by POST /device_location_observations, via will be set to api. If created by a rule action and not set, via will default to unknown.

string

An optional time that the observation was taken. Valid values are ISO 8601 dates and times. If unset during creation, this will default to created_at.

geojson
object

A read only GeoJSON object of type Feature with geometry.coordinates equivalent to latitude and longitude and properties.radius equal to the radius of accuracy in meters. This is provided automatically by the system for convenience in placing the location observation on a map.

Responses
405

This method is not allowed for this resource type

500

An unexpected error was encountered.

Language
Credentials
Header
Response
Click Try It! to start a request and see the response here!