cURL

curl -X POST "https://api.fitsociety.io/public/v1/workout/clients/{clientId}/video-library/category/{categoryId}" \
  -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: 20,
    favourites: false,
    levels: ['Beginner'],
    categories: ['Strength'],
    coaches: [],
    search: ''
  })
};

fetch('https://api.fitsociety.io/public/v1/workout/clients/{clientId}/video-library/category/{categoryId}', 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/category/{categoryId}"

payload = {
    "page": 1,
    "limit": 20,
    "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": {
    "categoryId": "67f1234567890abcdef1234",
    "categoryName": "Strength & Power",
    "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"
        }
      }
    ],
    "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 all videos in a category (See All)

Client-only. Returns formatted (single-language) video cards for every published video in the given category, ordered by their category position. Accepts the same filter set as the home endpoint in the request body. Language is always resolved from the client’s profile. An empty category returns videos: [] (200, not 404). 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/category/:categoryId 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

workout

clients

{clientId}

video-library

category

{categoryId}

cURL

curl -X POST "https://api.fitsociety.io/public/v1/workout/clients/{clientId}/video-library/category/{categoryId}" \
  -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: 20,
    favourites: false,
    levels: ['Beginner'],
    categories: ['Strength'],
    coaches: [],
    search: ''
  })
};

fetch('https://api.fitsociety.io/public/v1/workout/clients/{clientId}/video-library/category/{categoryId}', 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/category/{categoryId}"

payload = {
    "page": 1,
    "limit": 20,
    "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": {
    "categoryId": "67f1234567890abcdef1234",
    "categoryName": "Strength & Power",
    "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"
        }
      }
    ],
    "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

Authorization

string

header

required

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

Idempotency-Key

string

required

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 - 200

Example:

"booking-create-20260714-001"

Path Parameters

categoryId

string

required

Video library category id.

Example:

"67f1234567890abcdef1234"

clientId

string

required

Client in the company bound to the Public API token.

Pattern: ^[a-fA-F0-9]{24}$

Body

application/json

page

integer

Required range: x >= 1

Example:

1

limit

integer

Required range: 1 <= x <= 100

Example:

20

favourites

boolean

Example:

false

levels

enum<string>[]

Available options:

Beginner,

Intermediate,

Advance

Example:

["Beginner"]

Response

Formatted video cards ordered by category position, with filter metadata.

data

object

required

Show child attributes

Workout V2

Health

OAuth

Platform

Company catalog

Clients

Calendar and bookings

Finance

Credits

Progress

Habits

Forms

Documents

Reports

Conversations

Exports

Webhooks

Get all videos in a category (See All)

Authorizations

Headers

Path Parameters

Body

Response