Skip to main content
POST
Log a weigh-in

Authorizations

__Secure-better-auth.session_token
string
cookie
required

Better Auth session. Signing in (Google or email magic link) sets an HttpOnly session cookie that scopes every request to that account. The web app and CLI use this; agents use the OAuth 2.1 flow of the MCP server.

Body

application/json

The weigh-in to record.

Body for logging a manual weigh-in.

weightKg
number
required

Body weight to log, in kilograms.

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

72.6

bodyFatPct
number | null

Optional body-fat percentage for the weigh-in.

Required range: 1 <= x <= 80
Example:

17.4

note
string

Optional note (truncated to 500 characters).

Maximum string length: 500
Example:

"morning, fasted"

Response

The reading was stored.

Minimal success acknowledgement for write operations.

ok
boolean
required

Always true.

Example:

true