Spread calendar programme workouts over available weekdays - FITsociety Developer APIs

cURL

curl -X POST "https://api.fitsociety.io/public/v1/workout/plans/moments/{planId}/auto-schedule" \
  -H "Authorization: Bearer <access_token>" \
  -H "Idempotency-Key: <stable_request_key>" \
  -H "Content-Type: application/json" \
  -d '{}'

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({weekdays: [1, 3, 5]})
};

fetch('https://api.fitsociety.io/public/v1/workout/plans/moments/{planId}/auto-schedule', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.fitsociety.io/public/v1/workout/plans/moments/{planId}/auto-schedule"

payload = { "weekdays": [1, 3, 5] }
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "data": {
    "weekNumbers": [
      1
    ],
    "schedule": {
      "mode": "multi_week",
      "releasePolicy": "weekly_from_start",
      "startDate": "2026-09-08",
      "timeZone": "Europe/Amsterdam",
      "totalWeeks": 4,
      "layout": "calendar_week",
      "weeks": [
        {
          "weekNumber": 1,
          "days": [
            {
              "weekday": 1,
              "isRestDay": false,
              "items": [
                {
                  "_id": "67f1234567890abcdef1234",
                  "order": 1,
                  "startTime": "08:30",
                  "plannedDurationMinutes": 45,
                  "status": "today",
                  "plannedDate": "2026-09-08",
                  "scheduledDate": "2026-09-08",
                  "source": "programme",
                  "clientAdjustment": {
                    "action": "moved",
                    "occurrenceDate": "2026-09-08",
                    "scheduledDate": "2026-09-08",
                    "changedAt": null
                  },
                  "canClientRestore": true,
                  "type": "workout",
                  "planMomentId": "67f1234567890abcdef1234"
                }
              ]
            }
          ]
        }
      ]
    }
  },
  "meta": {
    "requestId": "4f849d7d-f4f1-45cc-b4b7-3984a3d17f83",
    "rateLimit": {
      "limit": 10,
      "remaining": 9,
      "resetSeconds": 1
    },
    "idempotency": {
      "replayed": false
    }
  }
}

POST

/

public

/

v1

/

workout

/

plans

/

moments

/

{planId}

/

auto-schedule

cURL

curl -X POST "https://api.fitsociety.io/public/v1/workout/plans/moments/{planId}/auto-schedule" \
  -H "Authorization: Bearer <access_token>" \
  -H "Idempotency-Key: <stable_request_key>" \
  -H "Content-Type: application/json" \
  -d '{}'

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({weekdays: [1, 3, 5]})
};

fetch('https://api.fitsociety.io/public/v1/workout/plans/moments/{planId}/auto-schedule', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.fitsociety.io/public/v1/workout/plans/moments/{planId}/auto-schedule"

payload = { "weekdays": [1, 3, 5] }
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "data": {
    "weekNumbers": [
      1
    ],
    "schedule": {
      "mode": "multi_week",
      "releasePolicy": "weekly_from_start",
      "startDate": "2026-09-08",
      "timeZone": "Europe/Amsterdam",
      "totalWeeks": 4,
      "layout": "calendar_week",
      "weeks": [
        {
          "weekNumber": 1,
          "days": [
            {
              "weekday": 1,
              "isRestDay": false,
              "items": [
                {
                  "_id": "67f1234567890abcdef1234",
                  "order": 1,
                  "startTime": "08:30",
                  "plannedDurationMinutes": 45,
                  "status": "today",
                  "plannedDate": "2026-09-08",
                  "scheduledDate": "2026-09-08",
                  "source": "programme",
                  "clientAdjustment": {
                    "action": "moved",
                    "occurrenceDate": "2026-09-08",
                    "scheduledDate": "2026-09-08",
                    "changedAt": null
                  },
                  "canClientRestore": true,
                  "type": "workout",
                  "planMomentId": "67f1234567890abcdef1234"
                }
              ]
            }
          ]
        }
      ]
    }
  },
  "meta": {
    "requestId": "4f849d7d-f4f1-45cc-b4b7-3984a3d17f83",
    "rateLimit": {
      "limit": 10,
      "remaining": 9,
      "resetSeconds": 1
    },
    "idempotency": {
      "replayed": false
    }
  }
}

Authorizations

Authorization

string

header

required

Public API access token issued by /public/v1/oauth/token. Example: Authorization: Bearer fspt_.... Each resource request rechecks the token company's current provider access. Disabling access blocks existing tokens with 403 auth.provider_unavailable.

Headers

Idempotency-Key

string

required

Required for Public API write requests. Reusing the same key with the same method, path, and body replays the stored successful response; reusing it with a different request returns 409 idempotency.conflict.

Required string length: 1 - 200

Example:

"booking-create-20260714-001"

Path Parameters

planId

string

required

Workout plan id.

Example:

"67f1234567890abcdef1234"

Body

application/json

weekdays

integer[]

required

Available weekdays, 1 = Monday.

Required range: 1 <= x <= 7

Example:

[1, 3, 5]

weekNumbers

integer[]

Weeks to reschedule. Defaults to every week.

Required range: x >= 1

Example:

[2, 3]

keepActivities

boolean

default:true

false also spreads the week's activities over the chosen weekdays, after the workouts.

markEmptyAsRest

boolean

default:false

Turn every weekday left without items into a rest day.

Response

Rescheduled calendar weeks.

data

object

required

Show child attributes

meta

object

required

Show child attributes