IotHub
  1. Device
IotHub
  • API
    • TALQ
      • Device Class
        • Create a Talq Device Class
        • Update Talq Device Class
        • Delete a Talq Device Class
        • Update a Talq Device Class
      • Device
        • Create a Talq Device
        • List Talq Devices
        • Modify a Talq Device
        • Update Talq Devices
        • Delete a Talq Device
        • Get a Talq Device
        • Modify a Talq Device patch
        • Update a Talq Device
        • Get a Talq Device Function
        • Get a Talq Device Attribute
      • Services
        • Create a Talq Service
      • Group
        • List Talq Groups
        • Get a Talq Group
  • Docs TALQ
    • Introdução à especificação TALQ
    • Visão geral da API TALQ
    • Bootstrap process
    • Tier 1
      • Visão Geral
      • Solicitações
        • Criar Solicitação
        • Cancelar Solicitação
    • Tier 2
      • Visão geral
      • Bootstrap process
        • Device discovery
        • Classes discovery
        • Services announcement
        • Gateway update
        • Gateway class announcement
        • Gateway announcement
      • Device Class
        • Create a Talq Device Class
        • Update Talq Device Class
        • Delete a Talq Device Class
        • Update a Talq Device Class
      • Device
        • Get a Talq Device
          GET
        • Create a Talq Device
          POST
        • List Talq Devices
          GET
        • Modify a Talq Device
          PATCH
        • Update Talq Devices
          PUT
        • Delete a Talq Device
          DELETE
        • Modify a Talq Device patch
          PATCH
        • Update a Talq Device
          PUT
        • Get a Talq Device Function
          GET
        • Get a Talq Device Attribute
          GET
    • Tier 3
      • Visão Geral
      • Group
        • List Talq Groups
        • Get a Talq Group
      • Logger Configs
        • Get Logger Config
      • Log Reports
        • Send log report
    • Tier 4
      • Visão Geral
  1. Device

Update a Talq Device

PUT
/talq/devices/{deviceAddress}
Update a single device. Replaces the entire existing device definition. For the function array this will mean the existing device functions will be replaced with those specified in this call.

Request

Path Params

Query Params

Body Params application/json

Example
{
    "address": "{{device-uuid}}",
    "name": "{{$commerce.productAdjective}} {{$commerce.productName}}",
    "class": "cls:AllAttributes",
    "functions": [
        {
            "id": "fBasicFunction",
            "type": "BasicFunction",
            "Binary": {
                "type": "AttributeBinary",
                "value": "ON"
            },
            "Boolean": {
                "type": "AttributeBoolean"
            },
            "BooleanState": {
                "type": "AttributeBooleanState",
                "value": {
                    "name": "BooleanState",
                    "value": true
                }
            },
            "CabinetActuatingType": {
                "type": "AttributeCabinetActuatingType"
            },
            "CabinetSegmentsConfiguration": {
                "type": "AttributeCabinetSegmentsConfiguration",
                "value": [
                    {
                        "level": 1,
                        "segmentMonitors": [
                            {
                                "segmentMonitorFunctionId": "123",
                                "relayState": "OFF"
                            }
                        ]
                    },
                    {
                        "level": 100,
                        "segmentMonitors": []
                    }
                ]
            },
            "CCTColorState": {
                "type": "AttributeCCTColorState"
            },
            "Command": {
                "type": "AttributeCommand",
                "value": {
                    "state": {
                        "name": "LevelState",
                        "value": 50
                    }
                }
            },
            "ContentsType": {
                "type": "AttributeContentsType"
            },
            "DateTime": {
                "type": "AttributeDateTime"
            },
            "FactorSense": {
                "type": "AttributeFactorSense"
            },
            "Float": {
                "type": "AttributeFloat"
            },
            "FloatKVPArray": {
                "type": "AttributeFloatKVPArray"
            },
            "FloatState": {
                "type": "AttributeFloatState"
            },
            "GasName": {
                "type": "AttributeGasName"
            },
            "Integer": {
                "type": "AttributeInteger"
            },
            "IntegerState": {
                "type": "AttributeIntegerState"
            },
            "LevelAndCCTColorState": {
                "type": "AttributeLevelAndCCTColorState"
            },
            "LevelAndRGBWAFColorState": {
                "type": "AttributeLevelAndRGBWAFColorState"
            },
            "LevelAndXYColorState": {
                "type": "AttributeLevelAndXYColorState"
            },
            "LevelState": {
                "type": "AttributeLevelState"
            },
            "LocalOverride": {
                "type": "AttributeLocalOverride"
            },
            "Location": {
                "type": "AttributeLocation"
            },
            "LuminaireConnectionType": {
                "type": "AttributeLuminaireConnectionType"
            },
            "MountingOption": {
                "type": "AttributeMountingOption"
            },
            "Orientation": {
                "type": "AttributeOrientation"
            },
            "ParkingSlotDataArray": {
                "type": "AttributeParkingSlotDataArray"
            },
            "ParkingSlotOccupancyStatus": {
                "type": "AttributeParkingSlotOccupancyStatus"
            },
            "Percent": {
                "type": "AttributePercent"
            },
            "PositionedTextState": {
                "type": "AttributePositionedTextState"
            },
            "PowerSource": {
                "type": "AttributePowerSource"
            },
            "RGBState": {
                "type": "AttributeRGBState"
            },
            "RGBWAFColorState": {
                "type": "AttributeRGBWAFColorState"
            },
            "RoadUser": {
                "type": "AttributeRoadUser"
            },
            "String": {
                "type": "AttributeString"
            },
            "StringArray": {
                "type": "AttributeStringArray"
            },
            "SupplyType": {
                "type": "AttributeSupplyType"
            },
            "TextState": {
                "type": "AttributeTextState"
            },
            "TrafficDirection": {
                "type": "AttributeTrafficDirection"
            },
            "Uri": {
                "type": "AttributeUri",
                "value": "https://google.com"
            },
            "Velocity": {
                "type": "AttributeVelocity",
                "value": {
                    "horizontalVelocity": {
                        "horizontalSpeed": 1,
                        "bearing": 1
                    }
                }
            },
            "WindDirection": {
                "type": "AttributeWindDirection",
                "value": "N"
            },
            "XYColorState": {
                "type": "AttributeXYColorState",
                "value": {
                    "name": "XYColorState",
                    "x": 0.1
                }
            }
        }
    ]
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request PUT 'https://iot.exati.com.br/staging/talq/devices/{{device-uuid}}?clientAddress=' \
--header 'Content-Type: application/json' \
--data-raw '{
    "address": "{{device-uuid}}",
    "name": "{{$commerce.productAdjective}} {{$commerce.productName}}",
    "class": "cls:AllAttributes",
    "functions": [
        {
            "id": "fBasicFunction",
            "type": "BasicFunction",
            "Binary": {
                "type": "AttributeBinary",
                "value": "ON"
            },
            "Boolean": {
                "type": "AttributeBoolean"
            },
            "BooleanState": {
                "type": "AttributeBooleanState",
                "value": {
                    "name": "BooleanState",
                    "value": true
                }
            },
            "CabinetActuatingType": {
                "type": "AttributeCabinetActuatingType"
            },
            "CabinetSegmentsConfiguration": {
                "type": "AttributeCabinetSegmentsConfiguration",
                "value": [
                    {
                        "level": 1,
                        "segmentMonitors": [
                            {
                                "segmentMonitorFunctionId": "123",
                                "relayState": "OFF"
                            }
                        ]
                    },
                    {
                        "level": 100,
                        "segmentMonitors": []
                    }
                ]
            },
            "CCTColorState": {
                "type": "AttributeCCTColorState"
            },
            "Command": {
                "type": "AttributeCommand",
                "value": {
                    "state": {
                        "name": "LevelState",
                        "value": 50
                    }
                }
            },
            "ContentsType": {
                "type": "AttributeContentsType"
            },
            "DateTime": {
                "type": "AttributeDateTime"
            },
            "FactorSense": {
                "type": "AttributeFactorSense"
            },
            "Float": {
                "type": "AttributeFloat"
            },
            "FloatKVPArray": {
                "type": "AttributeFloatKVPArray"
            },
            "FloatState": {
                "type": "AttributeFloatState"
            },
            "GasName": {
                "type": "AttributeGasName"
            },
            "Integer": {
                "type": "AttributeInteger"
            },
            "IntegerState": {
                "type": "AttributeIntegerState"
            },
            "LevelAndCCTColorState": {
                "type": "AttributeLevelAndCCTColorState"
            },
            "LevelAndRGBWAFColorState": {
                "type": "AttributeLevelAndRGBWAFColorState"
            },
            "LevelAndXYColorState": {
                "type": "AttributeLevelAndXYColorState"
            },
            "LevelState": {
                "type": "AttributeLevelState"
            },
            "LocalOverride": {
                "type": "AttributeLocalOverride"
            },
            "Location": {
                "type": "AttributeLocation"
            },
            "LuminaireConnectionType": {
                "type": "AttributeLuminaireConnectionType"
            },
            "MountingOption": {
                "type": "AttributeMountingOption"
            },
            "Orientation": {
                "type": "AttributeOrientation"
            },
            "ParkingSlotDataArray": {
                "type": "AttributeParkingSlotDataArray"
            },
            "ParkingSlotOccupancyStatus": {
                "type": "AttributeParkingSlotOccupancyStatus"
            },
            "Percent": {
                "type": "AttributePercent"
            },
            "PositionedTextState": {
                "type": "AttributePositionedTextState"
            },
            "PowerSource": {
                "type": "AttributePowerSource"
            },
            "RGBState": {
                "type": "AttributeRGBState"
            },
            "RGBWAFColorState": {
                "type": "AttributeRGBWAFColorState"
            },
            "RoadUser": {
                "type": "AttributeRoadUser"
            },
            "String": {
                "type": "AttributeString"
            },
            "StringArray": {
                "type": "AttributeStringArray"
            },
            "SupplyType": {
                "type": "AttributeSupplyType"
            },
            "TextState": {
                "type": "AttributeTextState"
            },
            "TrafficDirection": {
                "type": "AttributeTrafficDirection"
            },
            "Uri": {
                "type": "AttributeUri",
                "value": "https://google.com"
            },
            "Velocity": {
                "type": "AttributeVelocity",
                "value": {
                    "horizontalVelocity": {
                        "horizontalSpeed": 1,
                        "bearing": 1
                    }
                }
            },
            "WindDirection": {
                "type": "AttributeWindDirection",
                "value": "N"
            },
            "XYColorState": {
                "type": "AttributeXYColorState",
                "value": {
                    "name": "XYColorState",
                    "x": 0.1
                }
            }
        }
    ]
}'

Responses

🟢200OK
application/json
The device is successfully updated
Body

Example
[
    {
        "address": "string",
        "name": "string",
        "class": "string",
        "functions": [
            {
                "id": "string",
                "type": "BasicFunction"
            }
        ]
    }
]
🟠400Bad Request
🟠403Forbidden
🟠404Record Not Found
🟠409409
🟠422Parameter Error
Modified at 2025-09-11 13:07:48
Previous
Modify a Talq Device patch
Next
Get a Talq Device Function