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

Add a training day

Adds a training day to an active mesocycle’s week. Mid-mesocycle it starts in the week of the next session due (earlier weeks don’t count as skipped); its exercises start at MEV.

POST/api/training/mesocycles/{id}/days
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.

Path parameters
idstringrequired

Identifier of the mesocycle, training day, set, slot, or custom exercise the path names.

Request body
requiredapplication/json

The day's label, position, and exercises.

labelstring

Label for the new day.

positioninteger

Day number to insert at (default last); later days shift down.

min 1
slotsSlotInput[]required

The new day's exercises, in order.

min items 1 · max items 12
Show properties
Array of SlotInput
musclestring

Muscle key (inferred from the exercise when omitted).

exerciseIdstring

Library id of the exercise to add.

exerciseNamestring

Name of the exercise to add, matched against the library when no id is given.

positioninteger

Order within the day (default last). Only used when adding to an existing day.

min 1
Responses
200

The new day.

object
400

The request body or parameters failed validation.

errorstringrequired

Human-readable failure reason.

detailstring

Optional extra context, present on upstream failures.

404

No matching resource owned by the caller.

errorstringrequired

Human-readable failure reason.

detailstring

Optional extra context, present on upstream failures.

Try it
Server
Authorization
Parameters
Bodyapplication/json
Request
curl -X POST 'https://app.skcal.fit/api/training/mesocycles/9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d/days' \
  -H 'Cookie: __Secure-better-auth.session_token=YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "label": "Arms",
  "position": 3,
  "slots": [
    {
      "muscle": "biceps"
    },
    {
      "muscle": "triceps",
      "exerciseName": "cable pushdown"
    }
  ]
}'
Response
{
  "ok": true,
  "week": 2,
  "day": 1,
  "exerciseName": "Barbell Bench Press",
  "muscle": "chest"
}

Was this page helpful?