Modify devices

PATCH

/guia/devices

Partial update of a list of existing devices. Partially updates the existing device definition. For the function array each element passed in will be cross-referenced against items in the existing function array using the id. If they match, the existing function will be updated. If there is no match the function will be added. To remove functions from the array see ‘PUT’, where an empty or reduced function array can be passed in.

Request

Query Params

Header Params

Body Params application/json

Example

[
    {
        "uuid": "{{device-uuid}}",
        "deviceClassUuid": "5a153bc8-eec4-43c3-a373-ac7ce8722015",
        "functions": [
            {
                "type": "BasicFunction",
                "name": "fBasicFunction",
                "attributeValues": [
                    {
                        "type": "AttributeBoolean",
                        "name": "Boolean"
                    }
                ]
            }
        ]
    }
]

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PATCH 'https://iot.exati.com.br/guia/devices?vendorUuid=1483dc91-dbf2-4c7c-bf88-595cd3ad1925' \
--header 'x-guia-uuid;' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "uuid": "{{device-uuid}}",
        "deviceClassUuid": "5a153bc8-eec4-43c3-a373-ac7ce8722015",
        "functions": [
            {
                "type": "BasicFunction",
                "name": "fBasicFunction",
                "attributeValues": [
                    {
                        "type": "AttributeBoolean",
                        "name": "Boolean"
                    }
                ]
            }
        ]
    }
]'

Responses

🟢200OK

The devices were updated successfully.

This response does not have a body.

🟠400Bad Request

🟠403Forbidden

🟠404Record Not Found

🟠409409

🟠422Parameter Error

Modified at 2025-07-31 09:53:20

List Guia Gateways

Modify device