Thrive AI Health
Api reference

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.

GET
/v1/users/{user_id}/metrics/{metric}/measurements/{sample_id}

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
sample_id*Sample Id

Header Parameters

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

Response Body

application/json

application/json

curl -X GET "https://loading/v1/users/497f6eca-6276-4993-bfeb-53cbbbba6f08/metrics/string/measurements/string"
{
  "data": {}
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

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.

Delete a partner-owned sample

Only samples stamped with the caller's `provider: partner:{tenant_slug}` may be deleted. OAuth/native samples cannot be deleted by id — use `DELETE /v1/users/{user_id}/devices/{provider_slug}` for provider-wide removal. Returns `204 No Content`.