skcal API

HTTP API behind skcal, the AI-native way to manage your health. The iPhone, Android, and web apps, the CLI, and the MCP server are all clients of this typed API.

Every record is scoped to the signed-in account’s email, so one account can never read another’s data. The scale-ingest route is the one exception: it is authenticated with a bearer token and attributes readings to a configured owner.

Nutrition is logged from a freeform text description, which is sent to Claude, which returns per-item calories and protein.

Service

Liveness and identity probes.

• GET
  Liveness probe/api/health
• GET
  Resolve the current identity/api/whoami

Weight

Body-weight readings and per-reading notes.

• GET
  List weigh-ins/api/weight
• POST
  Log a weigh-in/api/weight
• PATCH
  Edit a weigh-in note/api/weight/{id}

Measurements

Body-part circumference measurements (stored in centimetres).

• GET
  List measurements/api/measurements
• POST
  Record a measurement/api/measurements

Nutrition

Per-day calorie and protein totals plus AI meal logging.

• GET
  List daily totals/api/nutrition
• PUT
  Upsert a day's totals/api/nutrition
• POST
  Log a meal from photos/api/nutrition/analyze
• POST
  Log a meal or workout from photos/api/log/analyze
• POST
  Log a meal from a description/api/nutrition/describe
• GET
  List meals for a day/api/nutrition/meals
• DELETE
  Delete a meal/api/nutrition/meals/{id}
• DELETE
  Delete a food item/api/nutrition/items/{id}
• GET
  Fetch a meal photo/api/nutrition/photo/{key}

Targets

Per-user goals: target weight, calories, and protein.

• GET
  Get goals/api/targets
• PUT
  Update goals/api/targets

Coach

AI coach chat grounded in the caller’s targets, intake, and weight trend.

• POST
  Ask the AI coach/api/agent

Workouts

Free-text and photo workout logging, normalized to platform-standard fields.

• POST
  Log a workout from a description/api/workouts/describe
• GET
  List a day's workouts/api/workouts
• DELETE
  Delete a workout/api/workouts/{id}

Phases

Goal phases (bulk, cut, maintain) with planned vs actual rate of weight change.

• GET
  List goal phases/api/phases
• POST
  Start a phase/api/phases
• PATCH
  Edit a phase/api/phases/{id}
• DELETE
  Delete a phase/api/phases/{id}
• POST
  End a phase/api/phases/{id}/end

Training

RP-style mesocycles: volume landmarks, planned sets, logging, feedback, and progression.

• GET
  Training library/api/training/library
• POST
  Add a custom exercise/api/training/exercises
• DELETE
  Delete a custom exercise/api/training/exercises/{id}
• GET
  List mesocycles/api/training/mesocycles
• POST
  Create a mesocycle/api/training/mesocycles
• GET
  Next workout/api/training/current
• GET
  Get a mesocycle/api/training/mesocycles/{id}
• PATCH
  Edit or end a mesocycle/api/training/mesocycles/{id}
• DELETE
  Delete a mesocycle/api/training/mesocycles/{id}
• GET
  Get a session/api/training/mesocycles/{id}/sessions/{week}/{day}
• POST
  Finish a session/api/training/mesocycles/{id}/sessions/{week}/{day}/complete
• PUT
  Rate a muscle/api/training/mesocycles/{id}/feedback
• POST
  Log sets by exercise/api/training/log
• PATCH
  Log or edit a set/api/training/sets/{id}
• DELETE
  Delete a set/api/training/sets/{id}
• POST
  Add a set/api/training/slots/{id}/sets
• PATCH
  Swap an exercise/api/training/slots/{id}

Dashboard

Pre-aggregated snapshot powering the home screen.

• GET
  Home-screen snapshot/api/dashboard

Account

The signed-in account itself, including permanent deletion.

• DELETE
  Delete the caller's account/api/account

Ingest

Token-authenticated machine ingest from the Bluetooth scale listener.

• POST
  Ingest a scale reading/api/ingest/weight

Spec

The OpenAPI document itself.

• GET
  OpenAPI document/openapi.json