Introduction

Base URL

https://api.thymia.ai

Authentication

All requests must include your API key in the x-api-key header:

x-api-key: YOUR_API_KEY

Your API key is a secret. Do not share it or expose it in client-side code. Contact support@thymia.ai immediately if your key is compromised.

Making your first request

import requests
url = "https://api.example.com/v1/account"
payload = {}
headers = {
    "x-api-key": "<apiKey>",
    "Content-Type": "application/json"
}
response = requests.get(url, json=payload, headers=headers)
print(response.json())

{
  "id": "a1b2c3d4-e5f6-7890-ab12-cd34ef567890",
  "features": [
    "data-export",
    "real-time-analytics",
    "user-management"
  ]
}

Request and response format

All request and response bodies use JSON. Timestamps use ISO 8601 format unless stated otherwise:

YYYY-MM-DDTHH:MM:SS+HH:MM

HTTP status codes

SDKs

Official SDKs are coming soon. The thymia API can be called from any language or framework that supports HTTP requests.

Endpoints