cURL
curl -X POST "https://api.fitsociety.io/public/v1/workout/clients/{clientId}/video-library/home" \
-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({
page: 1,
limit: 10,
favourites: false,
levels: ['Beginner'],
categories: ['Strength'],
coaches: [],
search: ''
})
};
fetch('https://api.fitsociety.io/public/v1/workout/clients/{clientId}/video-library/home', 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/clients/{clientId}/video-library/home"
payload = {
"page": 1,
"limit": 10,
"favourites": False,
"levels": ["Beginner"],
"categories": ["Strength"],
"coaches": [],
"search": ""
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"data": {
"isFilterApplied": false,
"videoLibrary": [
{
"categoryId": "67f1234567890abcdef1234",
"categoryName": "Strength & Power",
"categoryIcon": "🏋️",
"videos": [
{
"_id": "67f1234567890abcdef1234",
"title": "Core Fundamentals",
"description": "Learn the basics of core training.",
"url": "https://cdn.example.com/video-library/company123/thumb-en.jpg",
"platform": "s3",
"type": "video",
"duration": 300,
"language": "en",
"level": "Beginner",
"category": "Strength",
"isFavorite": false,
"progress": {
"watchedDuration": 120,
"progressPercentage": 40,
"isCompleted": false,
"lastWatchedAt": "2026-04-12T10:00:00.000Z"
}
}
],
"totalVideos": 12
}
],
"filteredData": [
{
"_id": "67f1234567890abcdef1234",
"title": "Core Fundamentals",
"description": "Learn the basics of core training.",
"url": "https://cdn.example.com/video-library/company123/thumb-en.jpg",
"platform": "s3",
"type": "video",
"duration": 300,
"language": "en",
"level": "Beginner",
"category": "Strength",
"isFavorite": false,
"progress": {
"watchedDuration": 120,
"progressPercentage": 40,
"isCompleted": false,
"lastWatchedAt": "2026-04-12T10:00:00.000Z"
}
}
],
"availableFilters": {
"favourites": [
true,
false
],
"levels": [
"Beginner",
"Intermediate",
"Advance"
],
"categories": [
"Strength",
"Cardio"
],
"coaches": [
{
"id": "67f1234567890abcdef1234",
"name": "Alex Jansen",
"image": "https://cdn.example.com/coaches/alex.jpg"
}
]
},
"selectedFilters": {
"favourites": false,
"levels": [],
"categories": [],
"coaches": [],
"search": ""
},
"pagination": {
"page": 1,
"limit": 10,
"totalItems": 15,
"totalPages": 2
}
},
"meta": {
"requestId": "4f849d7d-f4f1-45cc-b4b7-3984a3d17f83",
"rateLimit": {
"limit": 10,
"remaining": 9,
"resetSeconds": 1
},
"idempotency": {
"replayed": false
}
}
}
Client plans
Get video library home
Client-only. Accepts filters in the request body. Language is always resolved from the client’s profile. When no filters are active (isFilterApplied: false) returns grouped videoLibrary sections, each with up to 5 video cards. When any filter is active (isFilterApplied: true) returns a flat filteredData list — the inactive field is always []. availableFilters.coaches is dynamically populated from coaches who have published videos for this company.
Requires the workout_client_plans:write scope. This operation maps to /app/v1/workout/client/video-library/home and retains its Workout V2 permission, feature-flag, and resource-scope checks.
The clientId path parameter identifies the client represented by the request context.
POST
/
public
/
v1
/
workout
/
clients
/
{clientId}
/
video-library
/
home
cURL
curl -X POST "https://api.fitsociety.io/public/v1/workout/clients/{clientId}/video-library/home" \
-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({
page: 1,
limit: 10,
favourites: false,
levels: ['Beginner'],
categories: ['Strength'],
coaches: [],
search: ''
})
};
fetch('https://api.fitsociety.io/public/v1/workout/clients/{clientId}/video-library/home', 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/clients/{clientId}/video-library/home"
payload = {
"page": 1,
"limit": 10,
"favourites": False,
"levels": ["Beginner"],
"categories": ["Strength"],
"coaches": [],
"search": ""
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"data": {
"isFilterApplied": false,
"videoLibrary": [
{
"categoryId": "67f1234567890abcdef1234",
"categoryName": "Strength & Power",
"categoryIcon": "🏋️",
"videos": [
{
"_id": "67f1234567890abcdef1234",
"title": "Core Fundamentals",
"description": "Learn the basics of core training.",
"url": "https://cdn.example.com/video-library/company123/thumb-en.jpg",
"platform": "s3",
"type": "video",
"duration": 300,
"language": "en",
"level": "Beginner",
"category": "Strength",
"isFavorite": false,
"progress": {
"watchedDuration": 120,
"progressPercentage": 40,
"isCompleted": false,
"lastWatchedAt": "2026-04-12T10:00:00.000Z"
}
}
],
"totalVideos": 12
}
],
"filteredData": [
{
"_id": "67f1234567890abcdef1234",
"title": "Core Fundamentals",
"description": "Learn the basics of core training.",
"url": "https://cdn.example.com/video-library/company123/thumb-en.jpg",
"platform": "s3",
"type": "video",
"duration": 300,
"language": "en",
"level": "Beginner",
"category": "Strength",
"isFavorite": false,
"progress": {
"watchedDuration": 120,
"progressPercentage": 40,
"isCompleted": false,
"lastWatchedAt": "2026-04-12T10:00:00.000Z"
}
}
],
"availableFilters": {
"favourites": [
true,
false
],
"levels": [
"Beginner",
"Intermediate",
"Advance"
],
"categories": [
"Strength",
"Cardio"
],
"coaches": [
{
"id": "67f1234567890abcdef1234",
"name": "Alex Jansen",
"image": "https://cdn.example.com/coaches/alex.jpg"
}
]
},
"selectedFilters": {
"favourites": false,
"levels": [],
"categories": [],
"coaches": [],
"search": ""
},
"pagination": {
"page": 1,
"limit": 10,
"totalItems": 15,
"totalPages": 2
}
},
"meta": {
"requestId": "4f849d7d-f4f1-45cc-b4b7-3984a3d17f83",
"rateLimit": {
"limit": 10,
"remaining": 9,
"resetSeconds": 1
},
"idempotency": {
"replayed": false
}
}
}
Authorizations
Public API access token issued by /public/v1/oauth/token. Example: Authorization: Bearer fspt_.... Each resource request rechecks the token company's current provider access. Disabling access blocks existing tokens with 403 auth.provider_unavailable.
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
Client in the company bound to the Public API token.
Pattern:
^[a-fA-F0-9]{24}$Body
application/json
Required range:
x >= 1Example:
1
Required range:
1 <= x <= 100Example:
10
Example:
false
Available options:
Beginner, Intermediate, Advance Example:
["Beginner"]
Example:
["Strength"]
Filter by video creator coach IDs.
Example:
[]
Example:
""