Live test: Send data to a variable in a device

post

https://industrial.api.ubidots.com/api/v1.6/devices/{device_label}/{variable_label}/values

Send data to an existing variable in a device, or create a new variable in the device you choose.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Request body examples:

{
  "value": 10
}

{
  "value": 10,
  "timestamp": 1634311791000,
  "context": {
    "status": "cold"
  }
}

[
  {
    "value": 10, 
    "timestamp": 1635255765000,
    "context": {
      "status": "cold"
    }
  }, 
  {
    "value": 25, 
    "timestamp": 1635255811000,
    "context": {
      "status": "warm"
    }
  }
]

{
  "value": 1, 
  "context": {
    "lat": "6.5423", 
    "lng": "-70.5783"
  }
}

Path Params

device_label

string

required

The API label of the device to which data will be sent. Can be found in the device's left-side panel, below "icon".

variable_label

string

required

The API label of the variable to which data will be sent. Can be found in the variable's left-side panel, below "icon".

Query Params

timestamp

integer

Timestamp (in milliseconds POSIX format). When present, this timestamp will be applied to all dots in the body unless a local timestamp is sent.

token

string

The token to authenticate the request. Supported but not recommended. It's recommended to use the X-Auth-Token header instead.

type

string

Device Type label to be applied to the device if it doesn't exist yet.

status

boolean

When set to "true", an additional "_status" object will appear in the response, containing the IDs of the device and variables, as well as a "new" field indicating whether they were just created or not. Example:

{
"_status": {
"_datasource": {
"id": "61d8a6731d84726e96dba805",
"new": false
},
"temperature": {
"id": "61d8a6751d84726d00e5b7b8",
"new": true
}
},
...
}

Responses

200

400Bad Request

401Unauthorized