Route index
Every endpoint exposed by the Thrive AI Health Partner API, grouped by domain. For interactive try-it-now and full schemas, see the Interactive reference.
For interactive try-it-now, schemas, and auto-generated code samples, see the Interactive reference.
Applies to: v1. The interactive reference at /docs/api-reference is generated from the live OpenAPI document and is the canonical per-endpoint listing; this page is a tag-group orientation only.
Tag groups
The full grouping (matches the OpenAPI tags + sidebar order):
- Authentication: token issuance, tenant-key rotation, HMAC-secret rotation.
- Users: partner-linked member CRUD.
- Health profile: consolidated read model.
- Privacy settings.
- Programs.
- Nudges: AI-generated coaching cards + scheduled action reminders.
- Monthly reports (new 2026-04-25).
- Health actions.
- Coaching: text + voice threads, messages, file uploads. (Nutrition photo uploads now belong here, not a standalone group.)
- Onboarding.
- Async jobs.
- Labs.
- Notifications.
- Device management.
- Metrics and insights: activity, sleep, body, workouts, per-metric timeseries. (Workouts content moved into Metrics 2026-04-25.)
- Health scores: composite score, bio-age (new 2026-04-25), history.
- Event stream: async events delivered to partner-owned queues.
- Partner management (renamed from "Admin management" 2026-04-25); org, members/invites, tenant keys, queues.
Authentication
| Method | Path | Purpose | Auth |
|---|---|---|---|
POST | /v1/auth/token | Issue a short-lived member bearer token | Tenant |
POST | /v1/auth/tenant-key/rotate | Rotate the tenant API key with grace-period overlap | Tenant |
POST | /v1/auth/signing-secret/rotate | Rotate the event-signing HMAC secret with grace-period overlap | Tenant |
Users
| Method | Path | Purpose | Auth |
|---|---|---|---|
POST | /v1/users | Create a partner-linked member record | Tenant |
GET | /v1/users/{user_id} | Retrieve the current user profile | Member |
PATCH | /v1/users/{user_id} | Update a subset of user profile attributes | Member |
DELETE | /v1/users/{user_id} | Delete the user and all associated data | Member |
Health profile
| Method | Path | Purpose | Auth |
|---|---|---|---|
GET | /v1/users/{user_id}/health-profile | Consolidated partner-facing read model (profile + privacy + connected devices) | Member |
Other groups
Full per-endpoint tables for every group above are rendered from the OpenAPI spec at the Interactive reference. This page covers the surface summary; the interactive reference is the detail view.