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

Terra Authentication API

Connect and disconnect end-user wearable and health accounts.

Terra Authentication API is one of 11 APIs that Terra publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Authentication. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 4 operations across 4 paths. It is described by OpenAPI 3.0.3, at version 2.0.

Requests are made against a single base URL, https://api.tryterra.co/v2.

4 operations 4 paths 0 schemas 1 DELETE3 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
2.0
Base URL
https://api.tryterra.co/v2
Authentication
API Key, API Key
Contact
Resource Areas
1

Authentication & Security 2

Terra Authentication API declares 2 security schemes for authenticating requests. An API key is passed in the header as dev-id (devId). An API key is passed in the header as x-api-key (apiKey). By default, every request must be authenticated.

  • devId — Your public Terra developer identifier.
  • apiKey — Your secret Terra API key.

Paths & Operations 4

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

Authentication 4

Connect and disconnect end-user wearable and health accounts.

POST
/auth/authenticateUser
Generate a custom authentication link
authenticateUser body → 200401
POST
/auth/generateWidgetSession
Generate a Terra Widget session
generateWidgetSession body → 200401
POST
/auth/generateAuthToken
Generate an auth token for the Terra mobile SDKs
generateAuthToken → 200401
DELETE
/auth/deauthenticateUser
Deauthenticate a user
deauthenticateUser 1 param → 200401

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

terra-api-authentication-api-openapi.yml Raw ↑

Other APIs Terra publishes across the network.

Terra Webhooks
Terra Activity API
Terra Athlete API
Terra Body API
Terra Daily API
Terra Integrations API
Terra Menstruation API
Terra Nutrition API
Terra Sleep API
Terra Users API