Skip to content
skcal
Esc
↑↓navigate↵open⌘Jpreview

Update app settings

Changes the caller’s app preferences on every platform at once; omitted fields are left unchanged.

PUT/api/settings
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.

or
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 settings to change.

modestring

The app mode to switch to.

Allowed:fullworkout
onboardedboolean

True finishes or skips first-run onboarding.

Allowed:true
Responses
200

The settings after the change.

modestringrequired

full tracks training, nutrition, and body weight. workout is workout-only, with no calories, food logging, scale, or weigh-ins in the apps, and an agent that only coaches training.

Allowed:fullworkout
onboardedbooleanrequired

False for a new account that hasn't finished first-run setup; the apps open the agent's onboarding interview until it's true.

400

The request body or parameters failed validation.

errorstringrequired

Human-readable failure reason.

detailstring

Optional extra context, present on upstream failures.

Try it
Server
Authorization
Bodyapplication/json
Request
curl -X PUT 'https://app.skcal.fit/api/settings' \
  -H 'Cookie: __Secure-better-auth.session_token=YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "mode": "workout",
  "onboarded": true
}'
Response
{
  "mode": "workout",
  "onboarded": true
}

Was this page helpful?