Api reference

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`.

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`

curl -X DELETE "https://loading/v1/users/497f6eca-6276-4993-bfeb-53cbbbba6f08/metrics/string/measurements/string"

Empty

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

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.

AI-generated insights for a metric over a time range

`metric` is either a domain (`activity`, `sleep`, `body`, `vitals`) or a known per-metric slug (e.g. `heart_rate`, `steps`, `glucose`, `weight`). Per-metric slugs route to the domain that produces the relevant factoid — so `heart_rate` pulls from the sleep generator (which surfaces resting HR), `steps` from activity, `glucose` from vitals. The narrative describes the domain, but `key_findings` is filtered to the requested metric. `time_range` selects the analysis window; `language` is a BCP-47 code (default `en`).