cURL

curl -X PATCH "https://api.fitsociety.io/public/v1/workout/plans/template/{planId}/moments/{planMomentId}/supersets/{groupId}/exercises" \
  -H "Authorization: Bearer <access_token>" \
  -H "Idempotency-Key: <stable_request_key>" \
  -H "Content-Type: application/json" \
  -d '{}'

const options = {
  method: 'PATCH',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    planExerciseId: '67f1234567890abcdef1234',
    exerciseId: '67f1234567890abcdef1234'
  })
};

fetch('https://api.fitsociety.io/public/v1/workout/plans/template/{planId}/moments/{planMomentId}/supersets/{groupId}/exercises', 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/template/{planId}/moments/{planMomentId}/supersets/{groupId}/exercises"

payload = {
    "planExerciseId": "67f1234567890abcdef1234",
    "exerciseId": "67f1234567890abcdef1234"
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "data": {
    "planId": "67f1234567890abcdef1234",
    "planMomentId": "67f1234567890abcdef1234",
    "groupId": "6a2b1c3d4e5f60718293a4b5",
    "exerciseCount": 3,
    "exercises": [
      {
        "planExerciseId": "67f1234567890abcdef1234",
        "exerciseId": "67f1234567890abcdef1234",
        "order": 2
      }
    ]
  },
  "meta": {
    "requestId": "4f849d7d-f4f1-45cc-b4b7-3984a3d17f83",
    "rateLimit": {
      "limit": 10,
      "remaining": 9,
      "resetSeconds": 1
    },
    "idempotency": {
      "replayed": false
    }
  }
}

Plans

Add an exercise to a superset (existing day exercise OR catalog)

Adds an exercise to an existing superset (the “Add to Superset” action). Accepts EITHER source — send one of:

planExerciseId: an existing plan-day exercise subdoc _id → its groupId is set to the target superset (must currently be standalone).
exerciseId: a catalog (Exercisev2) _id from the exercise list → appended to the moment as a new exercise tagged with the group. If both are supplied, planExerciseId wins. The same movement (catalog exerciseId) must not already be in the superset, and the superset must stay without a size cap.

Requires the workout_plans:write scope. This operation maps to /app/v1/workout/plans/template/:planId/moments/:planMomentId/supersets/:groupId/exercises and retains its Workout V2 permission, feature-flag, and resource-scope checks.

The clientId path parameter is resolved inside the company bound to the Public API token when present.

PATCH

/

public

/

v1

/

workout

/

plans

/

template

/

{planId}

/

moments

/

{planMomentId}

/

supersets

/

{groupId}

/

exercises

cURL

curl -X PATCH "https://api.fitsociety.io/public/v1/workout/plans/template/{planId}/moments/{planMomentId}/supersets/{groupId}/exercises" \
  -H "Authorization: Bearer <access_token>" \
  -H "Idempotency-Key: <stable_request_key>" \
  -H "Content-Type: application/json" \
  -d '{}'

const options = {
  method: 'PATCH',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    planExerciseId: '67f1234567890abcdef1234',
    exerciseId: '67f1234567890abcdef1234'
  })
};

fetch('https://api.fitsociety.io/public/v1/workout/plans/template/{planId}/moments/{planMomentId}/supersets/{groupId}/exercises', 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/template/{planId}/moments/{planMomentId}/supersets/{groupId}/exercises"

payload = {
    "planExerciseId": "67f1234567890abcdef1234",
    "exerciseId": "67f1234567890abcdef1234"
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "data": {
    "planId": "67f1234567890abcdef1234",
    "planMomentId": "67f1234567890abcdef1234",
    "groupId": "6a2b1c3d4e5f60718293a4b5",
    "exerciseCount": 3,
    "exercises": [
      {
        "planExerciseId": "67f1234567890abcdef1234",
        "exerciseId": "67f1234567890abcdef1234",
        "order": 2
      }
    ]
  },
  "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"

planMomentId

string

required

Plan moment (day) id.

Example:

"67f1234567890abcdef1234"

groupId

string

required

Target superset group id.

Example:

"67f1234567890abcdef1234"

Body

application/json

Provide exactly one of planExerciseId or exerciseId.

planExerciseId

string

An existing plan-day exercise subdoc _id (regrouped into the superset). Takes precedence over exerciseId.

Example:

"67f1234567890abcdef1234"

exerciseId

string

A catalog (Exercisev2) _id to append to the moment and add to the superset.

Example:

"67f1234567890abcdef1234"

Response

Exercise added to superset.

data

object

required

Show child attributes

meta

object

required

Show child attributes