TintSense License API

Human-friendly live docs for activation, validation, and LemonSqueezy webhook sync. Raw schema is still available if needed.

Swagger UI OpenAPI JSON Health Check

Base URL

https://api.tintsense.com

OpenAPI schema: https://api.tintsense.com/openapi.json

Endpoints

GET/health

Returns worker and database health status.

POST/v1/licenses/activate

Activates a license key for a device and returns a persistent, device-revocable token plus entitlement snapshot.

{
  "activationKey": "TS-PRO-XXXX-XXXX",
  "deviceFingerprint": "device-fingerprint",
  "deviceLabel": "Figma Desktop",
  "pluginVersion": "1.0.0",
  "platform": "macOS"
}

POST/v1/licenses/validate

Refreshes license status using a bearer token or token in the request body.

{
  "deviceFingerprint": "device-fingerprint",
  "pluginVersion": "1.0.1"
}

POST/webhooks/billing/lemonsqueezy

Accepts LemonSqueezy order, subscription, refund, and license key events. Requires the X-Signature header.

LemonSqueezy Setup

Enable webhook events such as order_created, order_refunded, subscription_payment_success, subscription_expired, license_key_created, and license_key_updated.

Webhook URL: https://api.tintsense.com/webhooks/billing/lemonsqueezy
Signing header: X-Signature
Signing secret: WEBHOOK_VERIFICATION_SECRET