Documentation Index

Fetch the complete documentation index at: https://learn.servitly.com/llms.txt

Use this file to discover all available pages before exploring further.

Update thing metric value

Prev Next
Put
/data/values

Write a value of a thing metric, identified by the thingId and metricName query parameters.
This endpoint is the way to push into the DPS the data of products that do not publish them directly through the cloud connection, for instance devices reached through a third-party platform.
The payload carries a data array, where each element provides the timestamp of the sample and the list of values to store, so that several samples can be written with a single call.

Required permissions: READ_THING, WRITE_METRIC_VALUE.

Security
HTTP
Type bearer
Header parameters
X-Servitly-Tenant
stringRequired

The name of the tenant (e.g. acme).

Query parameters
thingId
stringRequired

The thing identifier the metric belongs to.

Minimum1.0
Exampleabcd1234
metricName
stringRequired

The name of the metric to update.

Maximum1.0
Body parameters

The new value payload.

Expand All
object
data
Array of object
object
timestamp
integer (int64)

The timestamp related to the metric value to update.

Example1695045244000
values
Array of object
object
value
string

The metric value to save.

Example123
Responses
201

Successful operation.

400

Request data not valid.

object
message
string

The error response.

ExampleBad request
401

User not authenticated.

object
message
string

The error response.

ExampleUser not authenticated
403

User not authorized.

object
message
string

The error response.

ExampleUser not authorized
404

Resource was not found.

object
message
string

The error response.

ExampleResource not found
429

API call rate limit exceeded.

object
message
string

The error response.

ExampleAPI call rate limit exceeded
500

Internal server error.

object
message
string

The error response.

ExampleInternal Server Error