Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

TagoIO Devices API

Manage devices using a Profile Token (admin-level).

TagoIO Devices API is one of 22 APIs that TagoIO publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 2 JSON Schema definitions.

Tagged areas include Devices. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 2 JSON Schemas.

This API exposes 12 operations across 6 paths, and defines 3 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0.

Requests are made against 2 base URLs: https://api.us-e1.tago.io, https://api.eu-w1.tago.io.

12 operations 6 paths 3 schemas 2 DELETE4 GET4 POST2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Base URL
https://api.us-e1.tago.io/
Authentication
API Key, API Key, API Key
Resource Areas
1

Authentication & Security 3

TagoIO Devices API declares 3 security schemes for authenticating requests. An API key is passed in the header as Device-Token (Device-Token). An API key is passed in the header as Token (Network-Token). An API key is passed in the header as Profile-Token (Profile-Token). By default, every request must be authenticated.

  • Device-Token — A Device-Token that is unique to your device. Generate a token by accessing your Device's page.
  • Network-Token — A Network Token that is unique to your Network. Access Integrations Network Tokens to generate a token for your Network.
  • Profile-Token — A Profile token that is unique to your entire profile. Generate in your account settings.

Paths & Operations 12

Across 6 paths, the API surfaces 12 operations — 2 DELETE, 4 GET, 4 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.

Devices 12

Manage devices using a Profile Token (admin-level).

GET
/device
List of Devices
listOfDevices 12 params → 200
POST
/device
Create Device
createNewDevice body → 201
GET
/device/{deviceID}
Device Information
deviceInformation 1 param → 200
PUT
/device/{deviceID}
Edit Device
editDevice 1 param body → 200
DELETE
/device/{deviceID}
Delete Device
deleteDevice 1 param → 200
POST
/device/{deviceID}/convert
Convert Device Type
convertDeviceType 1 param body → 200
GET
/device/{deviceID}/data_amount
Data Amount
deviceDataAmount 1 param → 200
POST
/device/{deviceID}/empty
Empty Device Storage
emptyADeviceSData 1 param → 200
GET
/device/{deviceID}/data
Get Device Data
getDeviceData 3 params → 200
POST
/device/{deviceID}/data
Send Device Data
sendDataToDevice 1 param body → 200
PUT
/device/{deviceID}/data
Edit Device Data
editDeviceData 1 param body → 200
DELETE
/device/{deviceID}/data
Delete Device Data
deleteDeviceData 8 params → 200

Schemas 3

The contract defines 3 schemas that model the data the API accepts and returns. The most detailed is DeviceDataItem (7 properties). Each schema is shown below with its type and property counts.

DeviceDataItem
object
7 properties 1 required
DeviceDataArray
array
Accepts a single item or an array of items.
DeviceData
Accepts a single item or an array of items when sent as application/json. For text/plain content, use the [Payload Parser](/docs/tagoio/devices/payload-parser/…

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

tago-io-devices-api-openapi.yml Raw ↑

Other APIs TagoIO publishes across the network.

TagoIO Access Management API
TagoIO Account API
TagoIO Backup API
TagoIO Configuration Param API
TagoIO Dashboards API
TagoIO Device Data API
TagoIO Device Tokens API
TagoIO Dictionary API
TagoIO Entity API
TagoIO Entity Data API
TagoIO Files API
TagoIO Immutable Device API