cURL
curl -X PUT "https://api.fitsociety.io/public/v1/workout/clients/{clientId}/exercises/{id}" \
-H "Authorization: Bearer <access_token>" \
-H "Idempotency-Key: <stable_request_key>" \
-H "Content-Type: application/json" \
-d '{}'const options = {
method: 'PUT',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
name: [
{lang: 'en', value: 'Full Body Strength'},
{lang: 'nl', value: 'Full Body Kracht'}
],
description: [
{lang: 'en', value: 'Full Body Strength'},
{lang: 'nl', value: 'Full Body Kracht'}
],
primaryCategory: 'Strength',
primaryMuscle: 'Chest'
})
};
fetch('https://api.fitsociety.io/public/v1/workout/clients/{clientId}/exercises/{id}', 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/clients/{clientId}/exercises/{id}"
payload = {
"name": [
{
"lang": "en",
"value": "Full Body Strength"
},
{
"lang": "nl",
"value": "Full Body Kracht"
}
],
"description": [
{
"lang": "en",
"value": "Full Body Strength"
},
{
"lang": "nl",
"value": "Full Body Kracht"
}
],
"primaryCategory": "Strength",
"primaryMuscle": "Chest"
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text){
"data": {},
"meta": {
"requestId": "4f849d7d-f4f1-45cc-b4b7-3984a3d17f83",
"rateLimit": {
"limit": 10,
"remaining": 9,
"resetSeconds": 1
},
"idempotency": {
"replayed": false
}
}
}
Client plans
Update a workout v2 exercise as a client
Videos share the company video-library storage allowance (25 decimal GB by default, admin adjustable). Coach web clients should use the exercise video-uploads presign/complete/status flow and send ready video URLs. Existing native multipart video uploads remain supported up to 100 MiB per file; these reserve the same quota and wait for the same compression worker. Legacy client-facing alias for PUT /app/v1/workout/exercises/exercise/{id}. New clients can use the shared route directly. Requires a client token. No permission policy applies here; the controller’s ownership check is the gate — a client may only update an exercise created by them (addedByRole: Client + matching addedBy, or a matching clientId), and the lookup is still scoped to the client’s active company. Accepts either application/json or multipart/form-data; in multipart requests, send structured arrays/objects as JSON strings and use imageFiles / videoFiles for uploads (the legacy binary aliases images and videos are still accepted).
Requires the workout_client_plans:write scope. This operation maps to /app/v1/workout/exercises/client-update/:id and retains its Workout V2 permission, feature-flag, and resource-scope checks.
The clientId path parameter identifies the client represented by the request context.
PUT
/
public
/
v1
/
workout
/
clients
/
{clientId}
/
exercises
/
{id}
cURL
curl -X PUT "https://api.fitsociety.io/public/v1/workout/clients/{clientId}/exercises/{id}" \
-H "Authorization: Bearer <access_token>" \
-H "Idempotency-Key: <stable_request_key>" \
-H "Content-Type: application/json" \
-d '{}'const options = {
method: 'PUT',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
name: [
{lang: 'en', value: 'Full Body Strength'},
{lang: 'nl', value: 'Full Body Kracht'}
],
description: [
{lang: 'en', value: 'Full Body Strength'},
{lang: 'nl', value: 'Full Body Kracht'}
],
primaryCategory: 'Strength',
primaryMuscle: 'Chest'
})
};
fetch('https://api.fitsociety.io/public/v1/workout/clients/{clientId}/exercises/{id}', 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/clients/{clientId}/exercises/{id}"
payload = {
"name": [
{
"lang": "en",
"value": "Full Body Strength"
},
{
"lang": "nl",
"value": "Full Body Kracht"
}
],
"description": [
{
"lang": "en",
"value": "Full Body Strength"
},
{
"lang": "nl",
"value": "Full Body Kracht"
}
],
"primaryCategory": "Strength",
"primaryMuscle": "Chest"
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text){
"data": {},
"meta": {
"requestId": "4f849d7d-f4f1-45cc-b4b7-3984a3d17f83",
"rateLimit": {
"limit": 10,
"remaining": 9,
"resetSeconds": 1
},
"idempotency": {
"replayed": false
}
}
}
Authorizations
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
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 - 200Example:
"booking-create-20260714-001"
Path Parameters
Workout v2 exercise id.
Example:
"67f1234567890abcdef1234"
Client in the company bound to the Public API token.
Pattern:
^[a-fA-F0-9]{24}$Body
application/jsonmultipart/form-data
Minimum array length:
1Show child attributes
Show child attributes
Example:
[ { "lang": "en", "value": "Full Body Strength" }, { "lang": "nl", "value": "Full Body Kracht" } ]
Minimum array length:
1Show child attributes
Show child attributes
Example:
[ { "lang": "en", "value": "Full Body Strength" }, { "lang": "nl", "value": "Full Body Kracht" } ]
Available options:
Agility & Speed, Strength, Hypertrophy, Strength - Dynamic, Strength - Explosive, Strength - Static, Cardio, Cardio - Duration, Cardio - Interval, HIIT, Crossfit, Mobility, Stretching, Core, Coordination & Balance, Movement Prep, Functional Training, Recovery, Sports, Martial Arts, Yoga, Other, GROUP_WORKOUT_TEMPLATE, Plyometric, Cycling, Cardio - interval, Mobilisation, Stabilisation, Daily Living, Target zone, Respiration, Breathing, Massage, Outdoor sports, Indoor sports, Dance, Group Lessons, Martial arts, Material Arts, Fight skills, Mind and body, default Example:
"Strength"
Available options:
Chest, Back, Lats, Traps, Shoulders, Biceps, Triceps, Forearms, Core, Abs, Obliques, Glutes, Quads, Hamstrings, Calves, Adductors, Abductors, Hip Flexors, Full Body, Cardio / Conditioning, Neck, Lower Back Example:
"Chest"
Available options:
Agility & Speed, Strength, Hypertrophy, Strength - Dynamic, Strength - Explosive, Strength - Static, Cardio, Cardio - Duration, Cardio - Interval, HIIT, Crossfit, Mobility, Stretching, Core, Coordination & Balance, Movement Prep, Functional Training, Recovery, Sports, Martial Arts, Yoga, Other, GROUP_WORKOUT_TEMPLATE, Plyometric, Cycling, Cardio - interval, Mobilisation, Stabilisation, Daily Living, Target zone, Respiration, Breathing, Massage, Outdoor sports, Indoor sports, Dance, Group Lessons, Martial arts, Material Arts, Fight skills, Mind and body, default Example:
["General Fitness"]
Available options:
Chest, Back, Lats, Traps, Shoulders, Biceps, Triceps, Forearms, Core, Abs, Obliques, Glutes, Quads, Hamstrings, Calves, Adductors, Abductors, Hip Flexors, Full Body, Cardio / Conditioning, Neck, Lower Back Example:
["Shoulders", "Triceps"]
Available options:
Ankle, Combination, Core, Elbow, Fingers, Hip, Knee, Neck, Shoulder, Spine, Wrist Example:
"Shoulder"
Available options:
Dumbbells, AdjustableDumbbells, Kettlebell, AdjustableKettlebell, CompetitionKettlebell, Medicineball, SlamBall, WallBall, Weightplate, BumperPlates, FractionalPlates, LoadableDumbbellHandle, Sandbag, StrongmanSandbag, Bulgarianbag, Aquabag, Aquaball, Hydrovest, MagneticBell, Macebell, SteelClub, IndianClub, Barbell, OlympicBarbell, TechniqueBar, EZBar, TrapBar, SafetySquatBar, SwissBar, CamberedBar, AxleBar, Landmine, Bench, FlatBench, AdjustableBench, InclineBench, DeclineBench, SealRowBench, HipThrustBench, BenchPressRack, SquatRack, SquatStand, PowerRack, WallMountedRack, HalfRack, SmithMachine, Monolift, JammerArms, BarbellJack, WeightTree, PlateStorage, DeadliftPlatform, Rig, StrengthMachinesPlateloaded, StrengthMachinesWeightstack, StrengthMachinesPneumatic, MultiGym, LegPressMachine, VerticalLegPressMachine, LeverageSquatMachine, LinearHackSquatMachine, BeltSquatMachine, PendulumSquatMachine, VSquatMachine, HackSquatMachine, LegExtensionMachine, LegCurlMachine, SeatedLegCurlMachine, LyingLegCurlMachine, StandingLegCurlMachine, StandingCalfRaiseMachine, SeatedCalfRaiseMachine, CalfPressMachine, HipThrustMachine, GluteDriveMachine, GluteKickbackMachine, HipExtensionMachine, HipAbductionMachine, HipAdductionMachine, ChestPressMachine, VerticalChestPressMachine, InclineChestPressMachine, DeclineChestPressMachine, IsoLateralChestPressMachine, IsoLateralInclinePressMachine, ShoulderPressMachine, IsoLateralShoulderPressMachine, MultiPressMachine, LateralRaiseMachine, RearDeltMachine, PecDeckMachine, PulloverMachine, LatPulldownMachine, IsoLateralLatPulldownMachine, AssistedPullupMachine, AssistedDipMachine, SeatedDipMachine, SeatedRowMachine, LowRowMachine, HighRowMachine, IsoLateralRowMachine, ChestSupportedRowMachine, TBarRowMachine, BicepsCurlMachine, PreacherCurlMachine, TricepsExtensionMachine, AbCrunchMachine, AbCoasterMachine, RotaryTorsoMachine, BackExtensionMachine, SeatedBackExtensionMachine, HyperextensionBench, ReverseHyper, GHD, Kinesis, Pulley, CableMachine, CableStation, CableColumn, CableCrossover, DualAdjustablePulley, SingleCableTower, FunctionalTrainer, TotalGymGTS, Gymstick, ViPR, RipTrainer, Battlerope, ProwlerSled, FarmersHandles, Yoke, Tire, Sledgehammer, TorqueTank, SledTrack, WallBallTarget, AgilityPoles, MiniHurdles, SprintParachute, PullUpBar, Parallelbars, DipBars, Equalizer, Suspensiontrainer, SuspensionSlingTrainer, GymnasticRings, MonkeyBars, PegBoard, RopeClimb, Wall, StallBars, DoorPullUpBar, PushUpHandles, AbStraps, Boxstep, SoftPlyoBox, Hurdle, Speedladder, Parallettes, NordicBench, SissySquatBench, Cardio, Treadmill, CurvedTreadmill, AirRunner, AssaultRunner, StationaryBike, UprightBike, RecumbentBike, BikeErg, SpinBike, AirBike, Rower, WaterRower, FanRower, ArmErgometer, SkiErg, Elliptical, ArcTrainer, NuStep, StairClimber, StepMill, JacobsLadder, VersaClimber, Bosu, Balanceball, Exerciseball, PilatesTennisball, PilatesRing, YogaMat, YogaBlock, YogaWheel, StretchStrap, MobilityStick, MassageBall, PeanutMassageBall, Airpad, Balanceboard, BalancePad, WobbleBoard, Glidedisc, Foamroller, Elasticbands, TherapyBand, Resistanceband, MiniBand, PullUpAssistBand, Powertube, AnkleWeights, SlantBoard, Vibrationtraining, CableRope, StraightBarAttachment, CurlBarAttachment, LatBarAttachment, TricepsBarAttachment, RowHandle, DHandle, DoubleDHandle, AnkleCuff, CableCuff, LandmineHandle, MagGripAttachment, DipBelt, AbWheel, WristRoller, FatGrip, Chain, DoorAnchor, JumpRope, SpeedRope, WeightedJumpRope, SledHarness, LiftingStraps, LiftingHooks, WristWraps, WeightliftingBelt, Clubbel, Stick, Bodybow, BuddySystem, Multinet, Flowin, Aerialhoop, Dancingpole, Trapeze, HulaHoop, Trampoline, XCO, PilatesReformer, PilatesChair, PilatesCadillac, PilatesBarrel, PilatesSpringboard, BalanceBeam, TreatmentTable, RehabTable, SlideBoard Example:
["Barbell", "Bench"]
Example:
6
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Available options:
Beginner, Intermediate, Advanced Example:
"Intermediate"
Available options:
Beginner, Below Average, Average, Above Average, High Intensity Example:
"Above Average"
Example:
["compound", "push"]
Available options:
Everyone, Company, Fitsociety Example:
"Company"
Optional fallback tracking type for freestyle sessions.
Available options:
reps, time, distance Example:
"reps"