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. You need to create a device in order to allow anything to send or receive data from your buckets. The communication between the external devices and Tago is done through ...
    • 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 ...
    • Managing Buckets

      By clicking on a bucket, you will find sections where you can find detailed information about the bucket. In your list of buckets, select one to get more information, and click on the MORE  tab to obtain the details. Visible This option can be used ...
    • 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 ...