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 Device Data API

Endpoints that act as a device using a Device Token (device-level permissions).

TagoIO Device Data 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 Device Data. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 2 JSON Schemas.

This API exposes 7 operations across 4 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.

7 operations 4 paths 3 schemas 1 DELETE3 GET1 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 Device Data 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 7

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

Device Data 7

Endpoints that act as a device using a Device Token (device-level permissions).

GET
/info
Device Information
currentDeviceInformation → 200
GET
/data
Get Data
getData 11 params → 200
PUT
/data
Edit Data
editData body → 200
POST
/data
Send Data
sendData body → 200
DELETE
/data
Delete Data
deleteData 7 params → 200
GET
/device/params
List Config. parameters
getConfigurationParameters 1 param → 200
PUT
/device/params/{paramID}
Mark Config. Parameter as Read
markAConfigurationParameterAsRead 1 param → 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-device-data-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 Tokens API
TagoIO Devices API
TagoIO Dictionary API
TagoIO Entity API
TagoIO Entity Data API
TagoIO Files API
TagoIO Immutable Device API