cURL
curl -X POST "https://api.fitsociety.io/public/v1/workout/groups/runs/{runId}/complete" \
-H "Authorization: Bearer <access_token>" \
-H "Idempotency-Key: <stable_request_key>" \
-H "Content-Type: application/json" \
-d '{}'const options = {
method: 'POST',
headers: {'Idempotency-Key': '<idempotency-key>', Authorization: 'Bearer <token>'}
};
fetch('https://api.fitsociety.io/public/v1/workout/groups/runs/{runId}/complete', 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/groups/runs/{runId}/complete"
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>"
}
response = requests.post(url, headers=headers)
print(response.text){
"data": {
"runId": "67f1234567890abcdef1234",
"status": "active",
"endedAt": null,
"completedCount": 3,
"cancelledCount": 1,
"runTimer": {
"timerStartedAt": null,
"timerPausedAt": null,
"timerElapsedMs": 120000
}
},
"meta": {
"requestId": "4f849d7d-f4f1-45cc-b4b7-3984a3d17f83",
"rateLimit": {
"limit": 10,
"remaining": 9,
"resetSeconds": 1
},
"idempotency": {
"replayed": false
}
}
}Group runs
Complete the entire group workout run
Completes the whole group workout run using the runId path parameter and the authenticated coach context. Each completed participant’s linked Planned booking becomes Completed for that calendar occurrence. Attendance and payment states remain independent, and deferred settlement continues. This endpoint does not require or read a request body; send no body or an empty JSON object.
Requires the workout_groups:write scope and the corresponding Workout features and permissions.
POST
/
public
/
v1
/
workout
/
groups
/
runs
/
{runId}
/
complete
cURL
curl -X POST "https://api.fitsociety.io/public/v1/workout/groups/runs/{runId}/complete" \
-H "Authorization: Bearer <access_token>" \
-H "Idempotency-Key: <stable_request_key>" \
-H "Content-Type: application/json" \
-d '{}'const options = {
method: 'POST',
headers: {'Idempotency-Key': '<idempotency-key>', Authorization: 'Bearer <token>'}
};
fetch('https://api.fitsociety.io/public/v1/workout/groups/runs/{runId}/complete', 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/groups/runs/{runId}/complete"
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>"
}
response = requests.post(url, headers=headers)
print(response.text){
"data": {
"runId": "67f1234567890abcdef1234",
"status": "active",
"endedAt": null,
"completedCount": 3,
"cancelledCount": 1,
"runTimer": {
"timerStartedAt": null,
"timerPausedAt": null,
"timerElapsedMs": 120000
}
},
"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"