curl -X PUT "https://api.fitsociety.io/public/v1/workout/cardio/clients/{clientId}/plans/{planId}/goal" \
-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({goal: {goalTimeSec: 123, raceDate: '2023-12-25', acceptGoalAsChallenge: false}})
};
fetch('https://api.fitsociety.io/public/v1/workout/cardio/clients/{clientId}/plans/{planId}/goal', 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/cardio/clients/{clientId}/plans/{planId}/goal"
payload = { "goal": {
"goalTimeSec": 123,
"raceDate": "2023-12-25",
"acceptGoalAsChallenge": False
} }
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": "66f7b8b1e13c8d25f4d3d90a",
"runningPlan": {
"goal": {
"distance": "5K",
"goalTimeSec": 1,
"raceDate": "2026-07-14",
"acceptGoalAsChallenge": true
},
"goalUpdatedAt": "2026-07-14T10:00:00.000Z",
"goalUpdatedBy": "string",
"adaptationRevision": 1,
"lastReviewedWeek": 1,
"lastAdaptedAt": "2026-07-14T10:00:00.000Z",
"generation": {
"templateKey": "5K",
"variant": true,
"runWeekdays": [
1
],
"qualityWeekdays": [
1
],
"longRunWeekday": 1,
"phases": {
"base": 1,
"threshold": 1,
"sharpen": 1
},
"taperWeeks": 1,
"sourceVersion": "plansjablonen-v259-1",
"policyVersion": "safety-calendar-v1",
"generatedAt": "2026-07-14T10:00:00.000Z",
"generatedBy": "string",
"profileUpdatedAt": "2026-07-14T10:00:00.000Z",
"totalWeeks": 1,
"concreteWeeks": 1,
"baselineKm": 1,
"peakKm": 1,
"thresholdSecPerKm": 1,
"warnings": [
"string"
]
},
"weekSummaries": [
{
"weekNumber": 1,
"weekStart": "2026-07-14",
"phase": 1,
"phaseName": "Base building",
"theme": "Base building",
"weekKind": "build",
"rotationWeek": 1,
"targetVolumeKm": 1,
"concrete": true,
"requestedVolumeKm": 1,
"allocatedKm": 1,
"remainingKm": 1,
"concreteRequested": true,
"sessions": [
{
"weekday": 1,
"code": "drempel_c",
"sessionType": "threshold_continuous",
"controlMode": "hr",
"longRunTargetMinutes": 1,
"ladder": {
"step": 1,
"reps": 1,
"kmPerRep": 1
},
"continuousMinutes": 1,
"recoveryRangeSec": {
"low": 1,
"high": 1
},
"cardio": {
"slotKey": "string",
"sessionType": "easy",
"controlMode": "pace",
"ladderStep": 1,
"poolLengthM": 25,
"blocks": [
{
"_id": "67f1234567890abcdef1234",
"repeat": 1,
"steps": [
{
"_id": "67f1234567890abcdef1234",
"kind": "warmup",
"durationType": "time",
"durationValue": 1,
"target": {
"kind": "paceZone",
"zone": "E",
"basis": "lthr",
"low": 1,
"high": 1
},
"secondaryTarget": {
"kind": "paceZone",
"zone": "E",
"basis": "lthr",
"low": 1,
"high": 1
},
"notes": "string",
"stroke": "free",
"equipment": [
"pullBuoy"
],
"restMode": "rest",
"sendOffSec": 1,
"cadence": {
"low": 1,
"high": 1
}
}
]
}
],
"sourceTemplateId": null
},
"totals": {
"durationSec": 1,
"distanceM": 1,
"plannedDurationMinutes": 1,
"targetDistanceMeters": 1,
"zoneTimeSec": {}
}
}
]
}
]
}
},
"meta": {
"requestId": "4f849d7d-f4f1-45cc-b4b7-3984a3d17f83",
"rateLimit": {
"limit": 10,
"remaining": 9,
"resetSeconds": 1
},
"idempotency": {
"replayed": false
}
}
}Save the structured race goal of an assigned plan
Updates the structured race goal for an assigned calendar programme. Requires the cardio features and access to the target client. Initial generation requires an empty programme and complete prescription inputs; missing inputs or invalid volume return 422 without changes. Existing workouts are preserved. Calendar weeks include the race week, while training ends before the race date. Volume limits apply and growing weeks use easy intensity.
Requires the workout_client_plans:write scope and the corresponding Workout features and permissions.
The clientId path parameter identifies a client in the company bound to the Public API token.
curl -X PUT "https://api.fitsociety.io/public/v1/workout/cardio/clients/{clientId}/plans/{planId}/goal" \
-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({goal: {goalTimeSec: 123, raceDate: '2023-12-25', acceptGoalAsChallenge: false}})
};
fetch('https://api.fitsociety.io/public/v1/workout/cardio/clients/{clientId}/plans/{planId}/goal', 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/cardio/clients/{clientId}/plans/{planId}/goal"
payload = { "goal": {
"goalTimeSec": 123,
"raceDate": "2023-12-25",
"acceptGoalAsChallenge": False
} }
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": "66f7b8b1e13c8d25f4d3d90a",
"runningPlan": {
"goal": {
"distance": "5K",
"goalTimeSec": 1,
"raceDate": "2026-07-14",
"acceptGoalAsChallenge": true
},
"goalUpdatedAt": "2026-07-14T10:00:00.000Z",
"goalUpdatedBy": "string",
"adaptationRevision": 1,
"lastReviewedWeek": 1,
"lastAdaptedAt": "2026-07-14T10:00:00.000Z",
"generation": {
"templateKey": "5K",
"variant": true,
"runWeekdays": [
1
],
"qualityWeekdays": [
1
],
"longRunWeekday": 1,
"phases": {
"base": 1,
"threshold": 1,
"sharpen": 1
},
"taperWeeks": 1,
"sourceVersion": "plansjablonen-v259-1",
"policyVersion": "safety-calendar-v1",
"generatedAt": "2026-07-14T10:00:00.000Z",
"generatedBy": "string",
"profileUpdatedAt": "2026-07-14T10:00:00.000Z",
"totalWeeks": 1,
"concreteWeeks": 1,
"baselineKm": 1,
"peakKm": 1,
"thresholdSecPerKm": 1,
"warnings": [
"string"
]
},
"weekSummaries": [
{
"weekNumber": 1,
"weekStart": "2026-07-14",
"phase": 1,
"phaseName": "Base building",
"theme": "Base building",
"weekKind": "build",
"rotationWeek": 1,
"targetVolumeKm": 1,
"concrete": true,
"requestedVolumeKm": 1,
"allocatedKm": 1,
"remainingKm": 1,
"concreteRequested": true,
"sessions": [
{
"weekday": 1,
"code": "drempel_c",
"sessionType": "threshold_continuous",
"controlMode": "hr",
"longRunTargetMinutes": 1,
"ladder": {
"step": 1,
"reps": 1,
"kmPerRep": 1
},
"continuousMinutes": 1,
"recoveryRangeSec": {
"low": 1,
"high": 1
},
"cardio": {
"slotKey": "string",
"sessionType": "easy",
"controlMode": "pace",
"ladderStep": 1,
"poolLengthM": 25,
"blocks": [
{
"_id": "67f1234567890abcdef1234",
"repeat": 1,
"steps": [
{
"_id": "67f1234567890abcdef1234",
"kind": "warmup",
"durationType": "time",
"durationValue": 1,
"target": {
"kind": "paceZone",
"zone": "E",
"basis": "lthr",
"low": 1,
"high": 1
},
"secondaryTarget": {
"kind": "paceZone",
"zone": "E",
"basis": "lthr",
"low": 1,
"high": 1
},
"notes": "string",
"stroke": "free",
"equipment": [
"pullBuoy"
],
"restMode": "rest",
"sendOffSec": 1,
"cadence": {
"low": 1,
"high": 1
}
}
]
}
],
"sourceTemplateId": null
},
"totals": {
"durationSec": 1,
"distanceM": 1,
"plannedDurationMinutes": 1,
"targetDistanceMeters": 1,
"zoneTimeSec": {}
}
}
]
}
]
}
},
"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.
1 - 200"booking-create-20260714-001"