curl -X POST "https://api.fitsociety.io/public/v1/workout/exercises/company-coach" \
-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>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
tab: 'library',
page: 1,
limit: 20,
search: '',
muscleGroups: ['Chest'],
categories: ['Strength']
})
};
fetch('https://api.fitsociety.io/public/v1/workout/exercises/company-coach', 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/exercises/company-coach"
payload = {
"tab": "library",
"page": 1,
"limit": 20,
"search": "",
"muscleGroups": ["Chest"],
"categories": ["Strength"]
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"data": {
"tab": "library",
"exercises": [
{
"_id": "67f1234567890abcdef1234",
"name": "Barbell Hip Thrusts",
"thumbnail": "https://cdn.example.com/exercises/hip-thrust.jpg",
"primaryMuscle": "Legs/Glutes",
"secondaryMuscles": [
"Hamstrings"
],
"difficulty": "Intermediate",
"category": "Strength",
"equipment": [
"Barbell"
],
"exerciseType": "coach",
"lastUsedAt": "2026-04-12T10:00:00.000Z"
}
],
"availableFilters": {
"muscleGroups": [
"Chest",
"Back",
"Lats"
],
"categories": [
"Agility & Speed",
"Strength",
"Hypertrophy"
]
},
"selectedFilters": {
"search": "",
"muscleGroups": [],
"categories": [],
"excludeExerciseIds": []
},
"pagination": {
"page": 1,
"limit": 1,
"totalItems": 1,
"totalAvailableItems": 1,
"totalPages": 1,
"hasNextPage": true,
"hasPreviousPage": true,
"nextPage": 1,
"previousPage": 1
}
},
"meta": {
"requestId": "4f849d7d-f4f1-45cc-b4b7-3984a3d17f83",
"rateLimit": {
"limit": 10,
"remaining": 9,
"resetSeconds": 1
},
"idempotency": {
"replayed": false
}
}
}Coach exercise picker (Library / My / Last Used tabs)
Returns company-visible exercises selected by tab. library returns the visible library, my returns exercises created by the attributed coach, and lastUsed returns exercises from that coach’s plans in most recently used order with lastUsedAt. library and my are sorted by popularity, then newest. search, muscleGroups, and categories apply to every tab.
Read collections default to 10 records. limit accepts 1 through 100; larger values use 100. Continue with page using the returned pagination metadata. Shared or mixed catalogue browsing supports pages 1 through 10. Own-record and explicit company-only scopes have no page ceiling. pagination.totalItems describes the accessible browse window; pagination.totalAvailableItems gives the full matching count for bounded catalogues.
Requires the workout_library:read scope and the corresponding Workout features and permissions.
curl -X POST "https://api.fitsociety.io/public/v1/workout/exercises/company-coach" \
-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>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
tab: 'library',
page: 1,
limit: 20,
search: '',
muscleGroups: ['Chest'],
categories: ['Strength']
})
};
fetch('https://api.fitsociety.io/public/v1/workout/exercises/company-coach', 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/exercises/company-coach"
payload = {
"tab": "library",
"page": 1,
"limit": 20,
"search": "",
"muscleGroups": ["Chest"],
"categories": ["Strength"]
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"data": {
"tab": "library",
"exercises": [
{
"_id": "67f1234567890abcdef1234",
"name": "Barbell Hip Thrusts",
"thumbnail": "https://cdn.example.com/exercises/hip-thrust.jpg",
"primaryMuscle": "Legs/Glutes",
"secondaryMuscles": [
"Hamstrings"
],
"difficulty": "Intermediate",
"category": "Strength",
"equipment": [
"Barbell"
],
"exerciseType": "coach",
"lastUsedAt": "2026-04-12T10:00:00.000Z"
}
],
"availableFilters": {
"muscleGroups": [
"Chest",
"Back",
"Lats"
],
"categories": [
"Agility & Speed",
"Strength",
"Hypertrophy"
]
},
"selectedFilters": {
"search": "",
"muscleGroups": [],
"categories": [],
"excludeExerciseIds": []
},
"pagination": {
"page": 1,
"limit": 1,
"totalItems": 1,
"totalAvailableItems": 1,
"totalPages": 1,
"hasNextPage": true,
"hasPreviousPage": true,
"nextPage": 1,
"previousPage": 1
}
},
"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"
Body
Exclude one or more exercises from results (comma-separated string or array of exercise ObjectIds). Aliases accepted: excludeExerciseId / exerciseIds / exerciseId. Also readable from query excludeExerciseIds / excludeExerciseId. Invalid id → 400 WORKOUTEXERCISE_EXERCISEID_INVALID. Echoed in selectedFilters.excludeExerciseIds.
"6925d2764ac340a53e012927,6925d2764ac340a53e012928"