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

Get app settings

Returns the caller’s app preferences, which every client on the account follows.

GET/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.

Responses
200

The caller's settings.

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.

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

Was this page helpful?