IotHub Nouvenn
  1. Device
IotHub Nouvenn
  • 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
          POST
        • List Talq Devices
          GET
        • Modify a Talq Device
          PATCH
        • Update Talq Devices
          PUT
        • Delete a Talq Device
          DELETE
        • Get a Talq Device
          GET
        • Modify a Talq Device patch
          PATCH
        • Update a Talq Device
          PUT
        • Get a Talq Device Function
          GET
        • Get a Talq Device Attribute
          GET
      • Services
        • Create a Talq Service
      • Group
        • List Talq Groups
        • Get a Talq Group
  • Docs TALQ
    • Visão Geral do Projeto
    • Processo de Inicialização - Bootstrap Process
    • API TALQ
  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 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/talq/devices/{{device-uuid}}?clientAddress={{gateway-uuid}}' \
--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-07-30 16:53:29
Previous
Modify a Talq Device patch
Next
Get a Talq Device Function