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
    • Processo de Inicialização - Bootstrap Process
    • API TALQ
  • Docs TALQ
    • Tier 2
      • 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
    • Tier 3
      • Group
        • List Talq Groups
        • Get a Talq Group
  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-07-30 16:53:29
Previous
Modify a Talq Device patch
Next
Get a Talq Device Function