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.

Create

Create a device through POST method.

POST - https://api.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.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.tago.io/device

Delete

Delete the device by its ID.

DELETE - https://api.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.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.tago.io/device/token/:token

Response

{
    "status": true,
    "result": "Successfully Removed"
}
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 ...

    • Blueprint Devices

      Blueprint Devices are dynamic Devices available on Blueprint Dashboards. They can be changed by the user in realtime, and by doing so, the Dashboard will reload the data for the Widgets that use them. You can change the Blueprint Devices by selecting ...

    • 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 ...

    • 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 ...