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

Manage your own profile settings (Profile Token).

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

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

7 operations 7 paths 0 schemas 4 GET2 POST1 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 Profile 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 7 paths, the API surfaces 7 operations — 4 GET, 2 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Profile 7

Manage your own profile settings (Profile Token).

GET
/profiled/{id}/statistics
Profile Statistics
getAProfileStatistics 3 params → 200
GET
/profile/{id}/summary
Profile Summary
getAProfileSummary 1 param → 200
GET
/profile/{id}
Profile Information
getAProfileDetails 1 param → 200
PUT
/profile/{id}/service
Configure Service Provider
configureProfileService 1 param body → 200400401403
POST
/profile/{id}/service/test/{service_type}
Test Service Provider
testProfileService 2 params body → 200400404500
POST
/account/profile/token
Generate Profile-Token
generateProfileToken body → 200
GET
/tags/keys/{type}
List Used Tags
getTags 1 param → 200

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

tago-io-profile-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 API
TagoIO Entity Data API
TagoIO Files API