Bulk Update Organizations

This endpoint updates all Organization fields for multiple Organizations.

📘

Updating a Single Field

To update only a single field of an Organization, please use the PATCH method with the parameters that need to be changed.

Request

To update all attributes of one or more Organization(s) please make a PUT request to the following URL:

HTTP MethodURL
POSThttps://industrial.api.ubidots.com/api/v2.0/organizations/_/bulk/update/

🚧

It's a POST

Please note that it's a POST request and not a PUT request.

Query Parameters

ParameterTypeUseDescription
tokenStringAuthenticationAuthentication Token can optionally be sent as a query parameter.

Body Parameters

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

ParameterTypeRequired?Default ValueDescription
idStringYesN/A (Required)The id of the organization desired to be updated
labelStringNo""The API label of Organization
nameStringNoSame as labelName of the Organization
descriptionStringNo""Description of Organization
faviconStringNonullIcon of Organization. How to update the favicon
logoStringNonullLogo of Organization. How to update the logo
propertiesObjectNo{}Organization properties
isActiveBooleanNoTrueIs True when Organization is active
app<app_key>NonullKey of App (id or label)

Header

ParameterRequired?Description
X-Auth-TokenYes[Authentication Token] (/reference/authentication) of account
X-Bulk-OperationYesNeed to be set to True for the bulk operation to work
Content-TypeYesContent type of body
$ curl -X POST 'https://industrial.api.ubidots.com/api/v2.0/organizations/_/bulk/update/' \
 -H 'Content-Type: application/json' \
 -H 'X-Auth-Token: oaXBo6ODhIjPsusNRPUGIK4d72bc73' \
 -H 'X-Bulk-Operation: True' \
 -d '[
  {
    "id": "6027087b65a24d1987654321",
    "isActive": true,
    "label": "org1",
    "name": "Organization 1",
    "description": "Organization One",
    "app": null,
    "properties": {"color": "#BADA55"}
  },
  ...
  {
    "id": "6027087b65a24d19acbd0987",
    "isActive": true,
    "label": "org2",
    "name": "Organization 2",
    "description": "Organization Two",
    "app": null,
    "properties": {"color": "#BAD995"}
  }
]'
{
  "task": {
    "id": "4974ac3a88301c016192"
  }
}
{
    "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.