cURL
curl -X PUT "https://api.fitsociety.io/public/v1/workout/plans/moments/exercises/{planId}/{planMomentId}/{exerciseId}/note" \
-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({
notes: 'Maintain a slow, 3-second descent. Sit back into your hips and drive through your heels.'
})
};
fetch('https://api.fitsociety.io/public/v1/workout/plans/moments/exercises/{planId}/{planMomentId}/{exerciseId}/note', 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/exercises/{planId}/{planMomentId}/{exerciseId}/note"
payload = { "notes": "Maintain a slow, 3-second descent. Sit back into your hips and drive through your heels." }
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text){
"data": {
"planId": "67f1234567890abcdef1234",
"planMomentId": "67f1234567890abcdef1234",
"exerciseId": "67f1234567890abcdef1234",
"notes": "Maintain a slow, 3-second descent."
},
"meta": {
"requestId": "4f849d7d-f4f1-45cc-b4b7-3984a3d17f83",
"rateLimit": {
"limit": 10,
"remaining": 9,
"resetSeconds": 1
},
"idempotency": {
"replayed": false
}
}
}Exercises
Upsert the coach note for an exercise across a plan
Upserts the coach note on every active occurrence of the same catalog exercise in the assigned plan, so the note remains available when the client advances to another plan moment. Send "" to clear it across those occurrences. note is accepted as an alias for notes. The caller must own the plan.
Requires the workout_plans:write scope and the corresponding Workout features and permissions.
PUT
/
public
/
v1
/
workout
/
plans
/
moments
/
exercises
/
{planId}
/
{planMomentId}
/
{exerciseId}
/
note
cURL
curl -X PUT "https://api.fitsociety.io/public/v1/workout/plans/moments/exercises/{planId}/{planMomentId}/{exerciseId}/note" \
-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({
notes: 'Maintain a slow, 3-second descent. Sit back into your hips and drive through your heels.'
})
};
fetch('https://api.fitsociety.io/public/v1/workout/plans/moments/exercises/{planId}/{planMomentId}/{exerciseId}/note', 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/exercises/{planId}/{planMomentId}/{exerciseId}/note"
payload = { "notes": "Maintain a slow, 3-second descent. Sit back into your hips and drive through your heels." }
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text){
"data": {
"planId": "67f1234567890abcdef1234",
"planMomentId": "67f1234567890abcdef1234",
"exerciseId": "67f1234567890abcdef1234",
"notes": "Maintain a slow, 3-second descent."
},
"meta": {
"requestId": "4f849d7d-f4f1-45cc-b4b7-3984a3d17f83",
"rateLimit": {
"limit": 10,
"remaining": 9,
"resetSeconds": 1
},
"idempotency": {
"replayed": false
}
}
}Authorizations
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
Body
application/json