Entity object

Definition

An entityObject reflects the JSON representation of an entity from the API, but it also provides 3 methods that let you interact with that instance.

Example

Suppose you retrieve data from a device as follows:

const firstDevice = await Ubidots.devices.first();

Here, firstDevice is an object that contains all the properties from the API representation of a device:

{
  "properties": {
    "_color": "#EA6F4C",
    "_icon": "cloud-sun",
    "_location_fixed": {
      "lat": 6.2486,
      "lng": 75.5742
    }
  },
  "createdAt": "2019-11-25T19:35:08.975270Z",
  "description": "some description",
  "id": "6e309da44fc8455a9cceb5aa",
  "isActive": true,
  "label": "first-device",
  "lastActivity": null,
  "name": "First Device",
  "organization": {
    "id": "af92e4c82bf1d39cc21882f5b",
    "label": "my-first-customer",
    "name": "My First Customer",
    "url": "http://industrial.ubidots.com/api/v2.0/organizations/af92e4c82bf1d39cc21882f5b"
  },
  "tags": ["first"],
  "url": "http://industrial.ubidots.com/api/v2.0/devices/6e309da44fc8455a9cceb5aa",
  "variables": "http://industrial.ubidots.com/api/v2.0/devices/6e309da44fc8455a9cceb5aa/variables",
  "variablesNumber": 1
}

In addition to the properties shown above, you can also invoke the following methods on firstDevice:

firstDevice.refresh();
firstDevice.update(args);
firstDevice.save(args);

Entity object methods

Method	Description	Usage	Arguments	Response
refresh	Returns the most recent state of the entityObject from the server.	Ubidots.<entity>.<get-method>(, [args]).refresh()	None	entityObject
update	Updates the entityObject fields on the server with the values in the object passed as an argument.	Ubidots.<entity>.<get-method>(, [args]).update(props)	props: object An object with at least 1 valid property of the given entity	entityObject
save	Updates the entire entityObject on the server with the values in the object passed as an argument.	Ubidots.<entity>.<get-method>(, [args]).save(props)	props: object An object containing all the properties of the given entity	entityObject