Edit a weigh-in note

Updates or clears the note on one of the caller’s past readings.

PATCH/api/weight/{id}

Authorization

__Secure-better-auth.session_tokenAPI key · cookierequired

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.

AuthorizationBearer token · headerrequired

Personal API key sent as Authorization: Bearer skcal_…. Create and scope keys in the app under your profile → API keys. Keys default to full access; a scoped key is limited to its granted resource:action permissions and cannot manage other keys.

Path parameters

idintegerrequired

Weight-reading identifier.

Request body

requiredapplication/json

The new note value, or null to clear it.

notestring | null

New note text, or null to clear it.

max length 500

Responses

200

The note was updated.

okbooleanrequired

Always true.

400

The request body or parameters failed validation.

errorstringrequired

Human-readable failure reason.

detailstring

Optional extra context, present on upstream failures.

404

No matching resource owned by the caller.

errorstringrequired

Human-readable failure reason.

detailstring

Optional extra context, present on upstream failures.

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

API keyRemember on this deviceInclude my values in samples

Parameters

idpath*Weight-reading identifier.

Bodyapplication/json

notestringNew note text, or null to clear it.

Request

curl -X PATCH 'https://app.skcal.fit/api/weight/0' \
  -H 'Cookie: __Secure-better-auth.session_token=YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "note": "re-weighed after workout"
}'

const response = await fetch("https://app.skcal.fit/api/weight/0", {
  method: "PATCH",
  headers: {
    "Cookie": "__Secure-better-auth.session_token=YOUR_API_KEY",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  body: "{\n  \"note\": \"re-weighed after workout\"\n}"
});

import requests

response = requests.patch(
    "https://app.skcal.fit/api/weight/0",
    headers={
        "Cookie": "__Secure-better-auth.session_token=YOUR_API_KEY",
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    data="{\n  \"note\": \"re-weighed after workout\"\n}",
)

Response

{
  "ok": true
}

{
  "error": "weightKg must be 9-320 kg",
  "detail": "upstream model returned 500"
}

{
  "error": "weightKg must be 9-320 kg",
  "detail": "upstream model returned 500"
}