Thrive AI Health
Api reference

Ingest sub-daily samples for a single metric

Up to 1000 items per request. `unit` must match the canonical unit for the metric (`bpm` for heart rate, `mg/dL` or `mmol/L` for glucose, `ms` for HRV, `mmHg` for blood pressure, `%` for blood oxygen, etc.); mismatches return `422 validation_error`. Same idempotency / provider-stamp / `is_backfill` semantics as the daily ingest endpoints.

POST
/v1/users/{user_id}/metrics/{metric}/timeseries

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
metric*Metric

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/string/timeseries" \  -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"
    }
  ]
}

Sub-daily samples for a single metric

Polymorphic by `metric` path segment. Currently supported slugs: `heart_rate`, `hrv`, `steps`, `calories` — additional metrics (`glucose`, `blood_pressure`, `respiratory_rate`, ECG voltage, body-temperature delta) are wired in follow-up tickets as the underlying UDP point-reads land. Unsupported slugs return `404`. `granularity` requests server-side aggregation (`raw`, `five_minute`, `fifteen_minute`, `one_hour`). Sample shape varies by metric: blood pressure has `systolic`/`diastolic`, ECG voltage has `lead`, body-temperature delta has `sensor_location`; everything else uses `value` + `unit`.

Fetch a single sample by id (deep-link)

Deep-link read for one sample. `metric` is one of `activity/summary`, `sleep/summary`, `body/summary`, `workouts/summary`, or `timeseries`. `sample_id` may be the server-returned UUID or the original `client_id` used on ingest. Response shape matches one entry from the corresponding list endpoint.