Update Device Type

This endpoints updates all fields of the Device Type specified in the body.

Request

To update one or more attributes of a specific Device Type please make a PUT request to the following URL:

HTTP MethodURL
PUThttps://industrial.api.ubidots.com/api/v2.0/device_types/<device_type_key>/

Path Parameters

ParameterTypeDescription
device_type_keyStringThe id or label of the Device Type, label should use the prefix ~

Query Parameters

ParameterTypeUseDescription
tokenStringAuthenticationAuthentication Token can optionally be sent as a query parameter.
update_devicesBooleanUpdateApply changes to all devices under thee Device type
apply_tasksBooleanRun tasksRun tasks for all devices under the Device type

Body Parameters

ParameterTypeRequired?Default ValueDescription
nameStringNoN/A (required)Name of Device Type
labelStringNoslug(label)Label of Device Type
descriptionStringNo""Description of Device Type
deviceColorStringNo""HTML Color of Device related to Device Type
deviceIconStringNo""Icon of Device related to Device Type
variableColorStringNo""Color of Variable related to Device Type
syntheticVariableColorStringNo""Color of Synthetic Variable related to Device Type
variablesObjectNo[]Variables related to Device Type
propertiesObjectNo[]Properties of Device Type
tasksObjectNo[]Tasks of Device Type

Header

ParameterRequired?Description
X-Auth-HeaderYesAuthentication Token of account
$ curl -X PUT 'https://industrial.api.ubidots.com/api/v2.0/device_types/<device_type_key>/' \
 -H 'Content-Type: application/json' \
 -H 'X-Auth-Token: oaXBo6ODhIjPsusNRPUGIK4d72bc73'
 -d ' {
    "name": "el type aquel",
    "label": "el-type-quel",
    "description": "La description aquella",
    "deviceColor": "#3BA9F5",
    "deviceIcon": "pencil",
    "variableColor": "#FFAE58",
    "syntheticVariableColor": "#",
    "variables": [],
    "properties": [],
    "tasks": []
}'
{
    "url": "https://industrial.api.ubidots.com/api/v2.0/device_types/5e1f7e5789f9bd7c4e7f1e2c",
    "id": "5e1f7e5789f9bd7c4e7f1e2c",
    "name": "el type aquel",
    "label": "el-type-quel",
    "description": "La description aquella",
    "deviceColor": "#3BA9F5",
    "deviceIcon": "pencil",
    "variableColor": "#FFAE58",
    "syntheticVariableColor": "#",
    "variables": [],
    "properties": [],
    "tasks": [],
    "createdAt": "2020-01-15T21:04:23.602975Z"
}
{
    "code": 400001,
    "message": "Validation Error.",
    "detail": {
        ....
    }
}
{
    "code": 401001,
    "message": "Authentication credentials were not provided.",
    "detail": "Authentication credentials were not provided."
}

Response

Returns a Device Type object with the updated Device Type.