Managing Devices

Managing Devices

Using the account-token, you can manage your devices through API requests. It’s possible to create, edit, delete, and get info of it.

Notes
When making a request to the TagoIO API, you must also specify the appropriate regional endpoint. Check out the available regions here: API documentation

Create

Create a device through POST method.

POST - https://api.<region>.tago.io/device

Request

{
    "name":        "My first device",
    "description": "Creating my first device",
    "active":      true,
    "visible":     true,
    "tags": [
        {"key": "client", "value": "John"}
    ],
    "configuration_params": [
        {"sent": false, "key": "check_rate", "value": 600},
        {"sent": false, "key": "measure_time", "value": 0}
    ]
}

Info

Retrieve informations for a device, using it’s ID.

GET - https://api.<region>.tago.io/device/:id

Response

{
    "status": true,
    "result": {
        "created_at": "2016-11-03T23:24:19.787Z",
        "updated_at": "2016-11-03T23:24:19.787Z",
        "last_access": "2016-11-03T23:24:19.787Z",
        "visible": true,
        "active": true,
        "tags": [
            {"key": "client", "value": "John"}
        ],
        "name": "My Device",
        "id": "581bc7233148f62587e2d507",
        "configuration_params": [
            {"sent": false, "key": "check_rate", "value": "600"}
            {"sent": false, "key": "measure_time", "value": ""}
        ],
        "bucket": {
            "name": "My Bucket",
            "id": "577bdd94567190920cfe9cfd"
        }
    }
}

List

Retrieve a list of all devices in the account.

GET - https://api.<region>.tago.io/device

Delete

Delete the device by its ID.

DELETE - https://api.<region>.tago.io/device/:id

Response

{
    "status": true,
    "result": "Successfully Removed"
}

Generate Token

Generate a new token for the device and return it.

POST - https://api.<region>.tago.io/device/token

Response

{
    "status": true,
    "result": {
        "token": "8be70d95-0dbc-4e16-89b6-b23b077d05e5"
    }
}

Delete Token

Delete device token by its token

DELETE - https://api.<region>.tago.io/device/token/:token

Response

{
    "status": true,
    "result": "Successfully Removed"
}
Info
When executing requests to TagoIO, you will have a limit on the number of requests that can be made during a certain time period. Read more about our Rate Limits.

    • Related Articles

    • Devices

      Device is the link between your external things and the data in your account. To allow anything to send or receive data from TagoIO, you need to create a device. The communication between external devices and TagoIO is done via HTTP or MQTT methods ...

    • Configuration Parameters for Devices

      Configuration Parameters are key-value pairs that enable you to customize the behavior of your Devices in different scenarios. For example, you can use them to specify how to decode data or send downlink messages, filter your devices on Widgets, or ...

    • RadioBridge Devices

      TagoIO is fully integrated with RadioBridge devices, that are connected over Sigfox or LoRaWAN, by providing the perfect integration with the Radio Bridge backend.  Read more about Radio Bridge. All data sent by your device will be readily available ...

    • Blueprint Devices & Entities

      Blueprint Devices and Entities serve as dynamic data sources for Blueprint Dashboards. These dashboards allow you to change data sources dynamically while retaining the same widgets and configurations. By creating blueprint devices or entities, you ...

    • Adding devices with connectors

      Connectors enables you to create a device with built-in behaviors that allow it to communicate with a Network very easily. When creating devices at TagoIO, it is important to know that there are different ways to allow them to send & receive data ...