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 Entity API

Manage entities (Profile Token).

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

This API exposes 6 operations across 3 paths. 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.

6 operations 3 paths 0 schemas 1 DELETE2 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 Entity 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 6

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

Entity 6

Manage entities (Profile Token).

GET
/entity
List Entities
listEntities 5 params → 200
POST
/entity
Create Entity
createEntity body → 200
GET
/entity/{entity_id}
Entity Information
getEntityInfo 1 param → 200
PUT
/entity/{entity_id}
Update Entity
updateEntity 1 param body → 200
DELETE
/entity/{entity_id}
Delete Entity
deleteEntity 1 param → 200
PUT
/entity/{entity_id}/schema
Update Entity Schema
updateEntitySchema 1 param body → 200

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

tago-io-entity-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 Devices API
TagoIO Dictionary API
TagoIO Entity Data API
TagoIO Files API
TagoIO Immutable Device API