Thrive AI Health
Api reference

Ingest body composition readings

Up to 500 items per request. Same ingest semantics as activity/sleep.

POST
/v1/users/{user_id}/metrics/body/summary

Authorization

MemberBearer
AuthorizationBearer <token>

Member-scoped JWT minted by POST /v1/auth/token. Required on every /v1/users/{user_id}/... route; the token's sub claim must match the path user_id.

In: header

Path Parameters

user_id*User Id
Formatuuid

Header Parameters

x-thrive-client-platform?string|null
org-id?string|null
x-user-id?string|null
x-request-id?string|null
traceparent?string|null
Idempotency-Key?|null

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

curl -X POST "https://loading/v1/users/497f6eca-6276-4993-bfeb-53cbbbba6f08/metrics/body/summary" \  -H "Content-Type: application/json" \  -d '{    "data": [      {}    ]  }'
{
  "data": [
    {
      "client_id": "string",
      "status": "accepted",
      "sample_id": "c94907f0-0a7b-412b-9563-59396ce4afee",
      "error": {}
    }
  ]
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Body composition readings for a date range

Body composition samples (weight, BMI, fat %, water %, muscle mass, lean mass, visceral fat, waist circumference) over a date window. Multiple samples per day are returned when the member weighs in repeatedly.

Workout sessions for a date range

Device-recorded workout sessions over a date window. Optional `sport` filter (canonical slug from `/v1/activity-types`) narrows by activity type. Note: this is the *measurement* of a workout that happened — for the *planned* workout (with blocks/steps), see the workouts service.