Update goals

Partially updates the caller’s targets; omitted fields are left unchanged.

PUT/api/targets

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.

Request body

requiredapplication/json

The fields to change; omitted fields are left unchanged.

goalWeightKgnumber

New target body weight in kilograms.

startWeightKgnumber

New starting body weight in kilograms.

dailyKcalTargetinteger

New daily calorie target.

proteinTargetGinteger

New daily protein target in grams.

targetDateinteger<int64>

New goal date as a Unix epoch in milliseconds.

activitystring

The user's day-to-day activity level in a few words; stored as their single activity-level memory (replacing any previous one).

max length 200

reasonstring

Optional context for why the targets changed; not stored.

max length 500

Responses

200

The targets were updated.

okbooleanrequired

Always true.

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

API keyRemember on this deviceInclude my values in samples

Bodyapplication/json

goalWeightKgnumberNew target body weight in kilograms.startWeightKgnumberNew starting body weight in kilograms.dailyKcalTargetintegerNew daily calorie target.proteinTargetGintegerNew daily protein target in grams.targetDateintegerNew goal date as a Unix epoch in milliseconds.activitystringThe user's day-to-day activity level in a few words; stored as their single activity-level memory (replacing any previous one).reasonstringOptional context for why the targets changed; not stored.

Request

curl -X PUT 'https://app.skcal.fit/api/targets' \
  -H 'Cookie: __Secure-better-auth.session_token=YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "goalWeightKg": 70,
  "startWeightKg": 78.4,
  "dailyKcalTarget": 2100,
  "proteinTargetG": 170,
  "targetDate": 1790000000000,
  "activity": "desk job, mostly sitting",
  "reason": "less active after a job change"
}'

const response = await fetch("https://app.skcal.fit/api/targets", {
  method: "PUT",
  headers: {
    "Cookie": "__Secure-better-auth.session_token=YOUR_API_KEY",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  body: "{\n  \"goalWeightKg\": 70,\n  \"startWeightKg\": 78.4,\n  \"dailyKcalTarget\": 2100,\n  \"proteinTargetG\": 170,\n  \"targetDate\": 1790000000000,\n  \"activity\": \"desk job, mostly sitting\",\n  \"reason\": \"less active after a job change\"\n}"
});

import requests

response = requests.put(
    "https://app.skcal.fit/api/targets",
    headers={
        "Cookie": "__Secure-better-auth.session_token=YOUR_API_KEY",
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    data="{\n  \"goalWeightKg\": 70,\n  \"startWeightKg\": 78.4,\n  \"dailyKcalTarget\": 2100,\n  \"proteinTargetG\": 170,\n  \"targetDate\": 1790000000000,\n  \"activity\": \"desk job, mostly sitting\",\n  \"reason\": \"less active after a job change\"\n}",
)

Response

{
  "ok": true
}