Update app settings
Changes the caller’s app preferences on every platform at once; omitted fields are left unchanged.
/api/settings__Secure-better-auth.session_tokenAPI key · cookierequiredBetter 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 · headerrequiredPersonal 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.
application/jsonThe settings to change.
modestringThe app mode to switch to.
fullworkoutonboardedbooleanTrue finishes or skips first-run onboarding.
trueThe settings after the change.
modestringrequiredfull 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.
fullworkoutonboardedbooleanrequiredFalse for a new account that hasn't finished first-run setup; the apps open the agent's onboarding interview until it's true.
The request body or parameters failed validation.
errorstringrequiredHuman-readable failure reason.
detailstringOptional extra context, present on upstream failures.