curl -X PUT "https://api.fitsociety.io/public/v1/workout/performance/activities/{planId}/{scheduleItemId}/{plannedDate}" \
-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({status: 'completed'})
};
fetch('https://api.fitsociety.io/public/v1/workout/performance/activities/{planId}/{scheduleItemId}/{plannedDate}', 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/performance/activities/{planId}/{scheduleItemId}/{plannedDate}"
payload = { "status": "completed" }
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text){
"data": {
"workBlocks": [
{
"blockId": "66f7b8b1e13c8d25f4d3d90a",
"stepId": "66f7b8b1e13c8d25f4d3d90a",
"repIndex": 1,
"durationSec": 1,
"distanceM": 1,
"avgPaceSecPerKm": 1,
"avgHrBpm": 1,
"avgPowerW": 1,
"avgCadenceRpm": 1,
"avgPaceSecPer100m": 1
}
],
"avgHrBpm": 1,
"missedReason": "sick",
"conditions": {
"temperatureC": 1,
"windNote": "string",
"elevationGainM": 1,
"preFatigueNote": "string"
},
"niggle": {
"note": "string"
},
"source": "manual",
"completedOnTarget": true,
"workBlockEvaluation": {
"reasonCodes": [
"SESSION_NOT_COMPLETED"
],
"blocks": [
{
"blockId": "66f7b8b1e13c8d25f4d3d90a",
"stepId": "66f7b8b1e13c8d25f4d3d90a",
"repIndex": 1,
"onTarget": true,
"reasonCode": "string"
}
]
},
"resolvedTargetsSnapshot": {
"source": "execution_snapshot",
"paceUnit": "s/km",
"sessionType": "easy",
"controlMode": "pace",
"blocks": [
{
"_id": "66f7b8b1e13c8d25f4d3d90a",
"repeat": 1,
"steps": [
{
"_id": "66f7b8b1e13c8d25f4d3d90a",
"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
},
"targetReasonCode": "string",
"secondaryTargetReasonCode": "string"
}
]
}
]
},
"externalWorkoutRef": "string",
"id": "67f1234567890abcdef1234",
"planId": "67f1234567890abcdef1234",
"programmeScheduleItemId": "67f1234567890abcdef1234",
"plannedDate": "2026-09-08",
"status": "completed",
"startedAt": null,
"completedAt": null,
"actualDurationMinutes": 45,
"actualDistanceMeters": 8000,
"notes": "Felt smooth.",
"rpe": 7
},
"meta": {
"requestId": "4f849d7d-f4f1-45cc-b4b7-3984a3d17f83",
"rateLimit": {
"limit": 10,
"remaining": 9,
"resetSeconds": 1
},
"idempotency": {
"replayed": false
}
}
}Save one programme activity occurrence
Starts, completes, or cancels one non-workout activity in an assigned calendar programme. The path identifies the authored occurrence; retries update that occurrence. Work-block fields require a structured running session and the cardio feature. Activity totals remain writable when the feature is disabled. The first running log captures the execution targets. completedOnTarget, workBlockEvaluation, resolvedTargetsSnapshot, and externalWorkoutRef are calculated by the API and cannot be supplied. Only the athlete can report a niggle, which activates their safety setting. Pace-led in_progress logs return CARDIO_NIGGLE_ACTIVE while that setting is active; completed historical activities can still be logged. The activity is executable throughout its available programme week.
Requires the workout_sessions:write scope and the corresponding Workout features and permissions.
curl -X PUT "https://api.fitsociety.io/public/v1/workout/performance/activities/{planId}/{scheduleItemId}/{plannedDate}" \
-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({status: 'completed'})
};
fetch('https://api.fitsociety.io/public/v1/workout/performance/activities/{planId}/{scheduleItemId}/{plannedDate}', 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/performance/activities/{planId}/{scheduleItemId}/{plannedDate}"
payload = { "status": "completed" }
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text){
"data": {
"workBlocks": [
{
"blockId": "66f7b8b1e13c8d25f4d3d90a",
"stepId": "66f7b8b1e13c8d25f4d3d90a",
"repIndex": 1,
"durationSec": 1,
"distanceM": 1,
"avgPaceSecPerKm": 1,
"avgHrBpm": 1,
"avgPowerW": 1,
"avgCadenceRpm": 1,
"avgPaceSecPer100m": 1
}
],
"avgHrBpm": 1,
"missedReason": "sick",
"conditions": {
"temperatureC": 1,
"windNote": "string",
"elevationGainM": 1,
"preFatigueNote": "string"
},
"niggle": {
"note": "string"
},
"source": "manual",
"completedOnTarget": true,
"workBlockEvaluation": {
"reasonCodes": [
"SESSION_NOT_COMPLETED"
],
"blocks": [
{
"blockId": "66f7b8b1e13c8d25f4d3d90a",
"stepId": "66f7b8b1e13c8d25f4d3d90a",
"repIndex": 1,
"onTarget": true,
"reasonCode": "string"
}
]
},
"resolvedTargetsSnapshot": {
"source": "execution_snapshot",
"paceUnit": "s/km",
"sessionType": "easy",
"controlMode": "pace",
"blocks": [
{
"_id": "66f7b8b1e13c8d25f4d3d90a",
"repeat": 1,
"steps": [
{
"_id": "66f7b8b1e13c8d25f4d3d90a",
"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
},
"targetReasonCode": "string",
"secondaryTargetReasonCode": "string"
}
]
}
]
},
"externalWorkoutRef": "string",
"id": "67f1234567890abcdef1234",
"planId": "67f1234567890abcdef1234",
"programmeScheduleItemId": "67f1234567890abcdef1234",
"plannedDate": "2026-09-08",
"status": "completed",
"startedAt": null,
"completedAt": null,
"actualDurationMinutes": 45,
"actualDistanceMeters": 8000,
"notes": "Felt smooth.",
"rpe": 7
},
"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"