Skip to main content
POST
Ingest a scale reading

Authorizations

Authorization
string
header
required

Shared secret carried as Authorization: Bearer <token>, used only by the scale-ingest route.

Body

application/json

The scale reading to ingest.

Body for a machine-submitted scale reading.

weightKg
number
required

Scale-reported body weight in kilograms.

Required range: 9 <= x <= 320
Example:

72.6

bodyFatPct
number | null

Optional scale-reported body-fat percentage.

Example:

17.4

userEmail
string<email>

Owner to attribute the reading to; falls back to the configured ingest user.

Example:

"nick@mintlify.com"

raw
object

Opaque raw payload from the scale, stored for debugging.

Example:

Response

The scale reading was ingested and stored.

Minimal success acknowledgement for write operations.

ok
boolean
required

Always true.

Example:

true