cURL

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": 20,
      "totalItems": 124,
      "totalPages": 7
    }
  },
  "meta": {
    "requestId": "4f849d7d-f4f1-45cc-b4b7-3984a3d17f83",
    "rateLimit": {
      "limit": 10,
      "remaining": 9,
      "resetSeconds": 1
    },
    "idempotency": {
      "replayed": false
    }
  }
}

Library

Coach exercise picker (Library / My / Last Used tabs)

Backs the coach exercise-picker screen. Branches on tab:

library (default) — all company-visible exercises (Everyone / Fitsociety / this Company), sorted by popularity then newest.
my — exercises created by this coach (addedByRole: Coach and addedBy = the requesting coach), sorted by popularity then newest. Every item has exerciseType: coach.
lastUsed — exercises pulled from the coach’s own plans, deduped and ordered most-recently-used first (each item carries lastUsedAt).

Filters (search, muscleGroups, categories) apply to every tab. The company is resolved from the coach’s token.

Requires the workout_library:read scope. This operation maps to /app/v1/workout/exercises/company-coach and retains its Workout V2 permission, feature-flag, and resource-scope checks.

The clientId path parameter is resolved inside the company bound to the Public API token when present.

POST

public

workout

exercises

company-coach

cURL

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": 20,
      "totalItems": 124,
      "totalPages": 7
    }
  },
  "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"

Body

application/json

tab

enum<string>

default:library

Which tab to compute. Defaults to library. Unknown values fall back to library.

Available options:

library,

my,

lastUsed

page

integer

Required range: x >= 1

Example:

1

limit

integer

Required range: 1 <= x <= 100

Example:

20

string

Case-insensitive name search. Applies to every tab.

Example:

"bench press"

muscleGroups

Matches primaryMuscle OR secondaryMuscles. Allowed values: Chest, Back, Lats, Traps, Shoulders …

Example:

"Chest,Shoulders"

Response

Coach exercises for the requested tab with available and selected filters.

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

Coach exercise picker (Library / My / Last Used tabs)

Authorizations

Headers

Body

Response