Bulk Update Devices

This endpoint updates multiple Device fields for multiple Devices.

Request

To update one or more specific attributes of one or more Device(s) please make a PATCH request to the following URL:

HTTP Method

URL

PATCH

https://industrial.api.ubidots.com/api/v2.0/devices/_/bulk/update/

Query Parameters

Parameter

Type

Use

Description

token

String

Authentication

Authentication Token can optionally be sent as a query parameter.

Body Parameters

The body is an Array containing Device JSON objects. Each Device object can contain the following any of the following body parameters:

Parameter

Type

Required?

Description

label

String

No

The API label of Device

name

String

No

Name of the Device

description

String

No

Description of Device

tags

String Array

No

Device tags

properties

Object

No

Device properties

organization

<organization_key>

No

Key of Organization (id or label)

Header

Parameter

Required?

Description

X-Auth-Token

Yes

Authentication Token of account

X-Bulk-Operation

Yes

Need to be set to True for the bulk operation to work

Content-Type

Yes

Content type of body

$ curl -X PATCH 'https://industrial.api.ubidots.com/api/v2.0/devices/_/bulk/update/' \
 -H 'Content-Type: application/json' \
 -H 'X-Auth-Token: oaXBo6ODhIjPsusNRPUGIK4d72bc73' \
 -H 'X-Bulk-Operation: True' \
 -d '[
  {
    "id": "5df7b9c01a9ca5714e7a1305",
    "name": "device 1"
  },
...
  {
    "id": "rgnbj7809ca5pIhpjgc345fc",
    "name": "device 4"
  }
]'
{
  "task": {
    "id": "tyg54645501a9ca5714e7b098721"
  }
}
{
    "code": 400001,
    "message": "Validation Error.",
    "detail": {
        ....
    }
}
{
    "code": 401001,
    "message": "Authentication credentials were not provided.",
    "detail": "Authentication credentials were not provided."
}
{
    "detail": "Header `X-BULK-OPERATION` should be provided for bulk operation."
}

Response

Returns a Task Id of the asynchronous process.