> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fitsociety.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Exercise detail — History & Statistics (combined)

> Returns exercise history and statistics together, with pagination and filters. tab does not select separate responses. History covers the client's plan and freestyle performances and retains the tracking type, targets, and grouping captured for each execution. Within equal performance, start, and creation timestamps, performance ID provides a stable order. Graph points are returned in statistics.chart. Each history day includes a data array. Supersets include isSuperset: true, groupId, supersetExerciseCount, and supersetExerciseNames in execution order; standalone performances use false, an empty groupId, 0, and an empty names array. For assisted_bodyweight, lower assistance is better; ties compare higher reps. Completed zero-assistance sets are valid. Assistance is excluded from lifted volume and estimated 1RM.

Read collections default to 10 records. limit accepts 1 through 100; larger values use 100. Continue with page using the returned pagination metadata. Owned collections have no page ceiling.

Requires the `workout_progress:read` scope and the corresponding Workout features and permissions.

The clientId path parameter identifies a client in the company bound to the Public API token.



## OpenAPI

````yaml /openapi/public-v1.json get /public/v1/workout/clients/{clientId}/library/exercises/{exerciseId}/history
openapi: 3.1.0
info:
  title: FITsociety Public API v1
  version: 1.0.0
  description: >-
    Integrate with FITsociety through `/public/v1`. Use OAuth client credentials
    to obtain a Bearer access token, then call the endpoints available to the
    authenticated company and granted scopes.
  contact:
    name: FITsociety Engineering
servers:
  - url: https://api.fitsociety.io
    description: Production
security: []
tags:
  - name: Health
    description: Public API token health checks.
  - name: OAuth
    description: Public API OAuth endpoints for server-to-server client credentials.
  - name: Platform
    description: Inspect Public API client context, capabilities, scopes, and audit logs.
  - name: Company Catalog
    description: Read and manage company profile metadata and locations.
  - name: Clients
    description: >-
      Create and manage clients through the Public API using Bearer access
      tokens.
  - name: Coaches
    description: Retrieve coaches for the authenticated company via integrations.
  - name: Calendar Events
    description: Read Public API calendar events.
  - name: Calendar Templates
    description: >-
      Read and manage event types and event templates used by calendar
      availability and bookings.
  - name: Calendar Extensions
    description: >-
      Read recurring bookings, booking requests, calendar tasks, and
      availability closure metadata.
  - name: Availability
    description: Read bookable availability slots and signed availability tokens.
  - name: Availability Management
    description: >-
      Manage coach and location availability templates used to derive bookable
      slots.
  - name: Bookings
    description: Read and manage Public API bookings.
  - name: Finance
    description: >-
      Read invoices, transactions, products, subscriptions, and memberships, and
      manage finance actions.
  - name: Credits
    description: >-
      Read company-wide and client-scoped credit allocations and mutations, and
      adjust credits.
  - name: Exports
    description: >-
      Create and monitor asynchronous company exports through Public API Bearer
      endpoints.
  - name: Webhooks
    description: >-
      Manage outbound webhook subscriptions and inspect delivery attempts
      through Public API Bearer endpoints.
  - name: Measurements
    description: Read and write client measurement entries.
  - name: Progress Photos
    description: Read client progress photo metadata and short-lived signed media URLs.
  - name: Forms
    description: Read, create, update, and archive company form templates.
  - name: Intakes
    description: Assign intake forms and read client intake assignments and submissions.
  - name: Check-ups
    description: >-
      Schedule and cancel client check-ups and read their status and
      submissions.
  - name: Documents
    description: >-
      Read client document and folder metadata, register external document
      links, update metadata, and archive documents from Public API listings.
      Binary upload, permanent deletion, and company-wide document management
      are not exposed.
  - name: Habits
    description: Read habits and habit entries.
  - name: Goals
    description: Read client goal summaries.
  - name: Conversations
    description: >-
      Read and manage direct and group chat conversations through the Public
      API.
  - name: Reports
    description: Read aggregate attendance, revenue, and retention summaries.
  - name: Workout
    description: >-
      Workout libraries, programmes, client plans, calendars, sessions, groups,
      settings and progress. AI operations are excluded.
paths:
  /public/v1/workout/clients/{clientId}/library/exercises/{exerciseId}/history:
    get:
      tags:
        - Workout
      summary: Exercise detail — History & Statistics (combined)
      description: >-
        Returns exercise history and statistics together, with pagination and
        filters. tab does not select separate responses. History covers the
        client's plan and freestyle performances and retains the tracking type,
        targets, and grouping captured for each execution. Within equal
        performance, start, and creation timestamps, performance ID provides a
        stable order. Graph points are returned in statistics.chart. Each
        history day includes a data array. Supersets include isSuperset: true,
        groupId, supersetExerciseCount, and supersetExerciseNames in execution
        order; standalone performances use false, an empty groupId, 0, and an
        empty names array. For assisted_bodyweight, lower assistance is better;
        ties compare higher reps. Completed zero-assistance sets are valid.
        Assistance is excluded from lifted volume and estimated 1RM.


        Read collections default to 10 records. limit accepts 1 through 100;
        larger values use 100. Continue with page using the returned pagination
        metadata. Owned collections have no page ceiling.


        Requires the `workout_progress:read` scope and the corresponding Workout
        features and permissions.


        The clientId path parameter identifies a client in the company bound to
        the Public API token.
      operationId: >-
        publicWorkoutgetPublicV1WorkoutClientsClientIdLibraryExercisesExerciseIdHistory
      parameters:
        - in: path
          name: exerciseId
          required: true
          description: Catalog Exercisev2 id.
          schema:
            type: string
            example: 67f1234567890abcdef1234
        - in: query
          name: clientId
          required: false
          schema:
            type: string
            example: 67f1234567890abcdef1234
          description: Required when the caller is a coach.
        - in: query
          name: page
          required: false
          schema:
            type: integer
            minimum: 1
            default: 1
          description: History pagination.
        - in: query
          name: limit
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 10
          description: History pagination.
        - in: query
          name: statsRange
          required: false
          schema:
            type: string
            enum:
              - last7days
              - last1month
              - last6months
              - all
            default: last7days
          description: >-
            Statistics chart range. `all` starts at the first completed
            performance and switches to monthly buckets for longer histories.
        - in: query
          name: leaderboardMetric
          required: false
          schema:
            type: string
            enum:
              - maxWeight
              - totalReps
              - totalTimeSeconds
              - estimated1RM
              - totalVolume
            default: maxWeight
          description: >-
            Metric for the Leaderboard tab (the metric-selector dropdown).
            Invalid/missing → `maxWeight`.
        - in: query
          name: leaderboardPage
          required: false
          schema:
            type: integer
            minimum: 1
            example: 1
            default: 1
          description: Leaderboard pagination (independent of the history `page`).
        - in: query
          name: leaderboardLimit
          required: false
          schema:
            type: integer
            minimum: 10
            maximum: 100
            example: 10
            default: 10
          description: >-
            Leaderboard page size (default 10; independent of the history
            `limit`).
        - name: clientId
          in: path
          required: true
          schema:
            type: string
            pattern: ^[a-fA-F0-9]{24}$
          description: Client in the company bound to the Public API token.
      responses:
        '200':
          description: Combined exercise history, statistics, and leaderboard.
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/PublicApiSuccessResponse'
                  - type: object
                    properties:
                      data:
                        $ref: >-
                          #/components/schemas/PublicWorkoutSourceGETAppV1WorkoutClientLibraryExercisesExerciseIdHistoryResponse200
              examples:
                success:
                  summary: Successful response
                  value:
                    data:
                      exercise:
                        _id: 67f1234567890abcdef1234
                        name: Dumbbell Bench Press
                        description: Example description
                        defaultType: ''
                        media:
                          - type: image
                            url: https://cdn.example.com/exercises/bench.jpg
                            platform: null
                            videoId: null
                            thumbnail: null
                            duration: null
                            width: 1280
                            height: 720
                        targetedMuscles:
                          - string
                        primaryCategory: string
                        secondaryCategories:
                          - string
                        equipment:
                          - string
                        difficulty: string
                        intensity: string
                        tags:
                          - string
                        muscleActivation:
                          total:
                            normalized: {}
                            maxValue: 1
                        muscleBalance:
                          - muscle: Arms
                            value: 1
                            normalized: 1
                        isFavourite: false
                        isClientOwn: false
                      libraryExercise:
                        primaryMuscle: Chest
                        description: Flat horizontal press with controlled tempo.
                        secondaryMuscles:
                          - Shoulders
                          - Triceps
                        primaryJoint: Shoulder
                        difficulty: Intermediate
                        intensity: Above Average
                        equipment:
                          - Barbell
                          - Bench
                        images:
                          - url: https://cdn.example.com/workouts/plan-cover.jpg
                            width: 1280
                            height: 720
                        videos:
                          - url: https://cdn.example.com/workouts/demo.mp4
                            platform: s3
                            videoId: ''
                            thumbnail: https://cdn.example.com/workouts/demo-thumb.jpg
                            duration: 84
                            width: 1920
                            height: 1080
                        defaultType: reps
                      history:
                        - performanceId: 67f1234567890abcdef1234
                          sessionId: 67f1234567890abcdef1234
                          isPersonalRecord: false
                          prVerified: false
                          prRank: null
                          planId: 66f7b8b1e13c8d25f4d3d90a
                          planMomentId: 66f7b8b1e13c8d25f4d3d90a
                          exerciseId: 66f7b8b1e13c8d25f4d3d90a
                          planExerciseId: 66f7b8b1e13c8d25f4d3d90a
                          executionContext:
                            mode: superset
                            groupId: superset-bench-row
                            restSeconds: 90
                            restSource: superset
                          planName: 30-Day High Intensity Belly Burn
                          type: reps
                          scheduleMode: multi_week
                          weekNumber: 2
                          dayName: Day A — Upper Body
                          freestyleName: Freestyle Workout 7
                          targets:
                            type: string
                            sets: 1
                            reps: string
                            rest: 1
                            rpe: 1
                            rmPercentage: 1
                            tempo: string
                            notes: string
                          date: '2026-07-14T10:00:00.000Z'
                          startedAt: '2026-01-09T07:32:00.000Z'
                          dateLabel: 09 Jan 2026
                          weekday: Monday
                          isCompleted: true
                          setCount: 4
                          sets:
                            - setNumber: 1
                              setType: W
                              rest: 10
                              reps: 15
                              weight: 15
                              timeSeconds: 1
                              distanceMeters: 1
                              rpe: 1
                              completed: true
                              isPersonalRecord: false
                              prVerified: false
                              prRank: 1
                              repsPlaceholderCoach: 10
                              weightPlaceholderCoach: 40
                              timeSecondsPlaceholderCoach: null
                              distanceMetersPlaceholderCoach: null
                              rpePlaceholderCoach: 7
                              restSecondsPlaceholderCoach: 90
                              repsPlaceholder: 10
                              weightPlaceholder: 40
                              timeSecondsPlaceholder: null
                              distanceMetersPlaceholder: null
                              rpePlaceholder: 7
                              restSecondsPlaceholder: 90
                              repsActual: 30
                              weightActual: 42
                              timeSecondsActual: null
                              distanceMetersActual: null
                              rpeActual: 8
                              restSecondsActual: 90
                      muscleActivation:
                        range:
                          startDate: '2026-07-14T10:00:00.000Z'
                          endDate: '2026-07-14T10:00:00.000Z'
                        total:
                          normalized: {}
                          maxValue: 320
                          topMuscles:
                            - muscle: chest
                              value: 18
                      pagination:
                        page: 1
                        limit: 10
                        totalPages: 8
                        totalItems: 78
                        hasNextPage: true
                        hasPreviousPage: false
                        nextPage: 2
                        previousPage: null
                        totalAvailableItems: 1
                      statistics:
                        cards:
                          timesPerformed: 78
                          totalSets: 456
                          totalReps: 187
                          frequencyPerWeek: 2
                        chart:
                          metric:
                            key: reps
                            label: Reps
                            unit: reps
                            exerciseType: reps
                            aggregation: max
                            direction: higher
                          granularity: day
                          range:
                            startDate: '2026-07-14T10:00:00.000Z'
                            endDate: '2026-07-14T10:00:00.000Z'
                            startDateLabel: 07-28-2026
                            endDateLabel: 08-20-2026
                          summary:
                            minimum: 1
                            average: 1
                            maximum: 1
                          points:
                            - date: '2026-07-14T10:00:00.000Z'
                              dateLabel: 07-28-2026
                              value: 1
                              label: '2026-01-09'
                              weight: 38.35
                              volume: 298.6
                              oneRm: 36.8
                              weightPer: 12.4
                              volumePer: 8.7
                              oneRmPer: 10.1
                              reps: 12
                              timeSeconds: 900
                              distanceMeters: 1500
                          previousRecords:
                            - performanceId: 67f1234567890abcdef1234
                              date: '2026-07-14T10:00:00.000Z'
                              dateLabel: 08-20-2026
                              value: 12
                        personalRecords:
                          maxWeight:
                            value: 40
                            unit: kg
                            achievedAt: '2026-07-14T10:00:00.000Z'
                          estimated1RM:
                            value: 46.5
                            unit: kg
                            achievedAt: '2026-07-14T10:00:00.000Z'
                          maxSetVolume:
                            value: 320
                            unit: kg
                            achievedAt: '2026-07-14T10:00:00.000Z'
                          maxSessionVolume:
                            value: 1280
                            unit: kg
                            achievedAt: '2026-07-14T10:00:00.000Z'
                      filters:
                        availableFilters:
                          statsRange:
                            - value: last7days
                              label: Last 7 days
                          leaderboardMetric:
                            - value: totalTimeSeconds
                              label: Time
                              unit: h
                        selectedFilters:
                          statsRange: last7days
                          leaderboardMetric: maxWeight
                      leaderboard:
                        enabled: true
                        hidden: false
                        metric: maxWeight
                        calculationMode: absolute
                        scoreUnit: kg
                        scoreDirection: desc
                        podium:
                          - rank: 4
                            clientId: 67f1234567890abcdef1234
                            firstName: Ann
                            lastName: Saris
                            name: Ann Saris
                            image: https://cdn.example.com/clients/ann.jpg
                            value: 180
                            displayScore: 180
                            displayValue: 180 kg
                            scoreUnit: kg
                            verificationStatus: verified
                            anonymousAvatar: false
                            isCurrentUser: false
                        data:
                          - rank: 4
                            clientId: 67f1234567890abcdef1234
                            firstName: Ann
                            lastName: Saris
                            name: Ann Saris
                            image: https://cdn.example.com/clients/ann.jpg
                            value: 180
                            displayScore: 180
                            displayValue: 180 kg
                            scoreUnit: kg
                            verificationStatus: verified
                            anonymousAvatar: false
                            isCurrentUser: false
                        currentUser:
                          rank: 4
                          clientId: 67f1234567890abcdef1234
                          firstName: Ann
                          lastName: Saris
                          name: Ann Saris
                          image: https://cdn.example.com/clients/ann.jpg
                          value: 180
                          displayScore: 180
                          displayValue: 180 kg
                          scoreUnit: kg
                          verificationStatus: verified
                          anonymousAvatar: false
                          isCurrentUser: false
                          inCurrentPage: true
                        totalParticipants: 156
                      paginationLeaderboard:
                        page: 1
                        limit: 10
                        totalPages: 16
                        totalItems: 153
                        hasNextPage: true
                        hasPreviousPage: false
                        nextPage: 2
                        previousPage: false
                        totalAvailableItems: 1
                    meta:
                      requestId: 4f849d7d-f4f1-45cc-b4b7-3984a3d17f83
                      rateLimit:
                        limit: 10
                        remaining: 9
                        resetSeconds: 1
        '400':
          description: >-
            Validation error. Keys: `INVALID_EXERCISE_ID`,
            `COMPANY_ID_REQUIRED`, `INVALID_CLIENT_ID`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiError'
              examples:
                invalidRequest:
                  summary: Invalid request
                  value:
                    error:
                      code: 400
                      key: request.invalid
                      message: The request is invalid.
                    meta:
                      requestId: 4f849d7d-f4f1-45cc-b4b7-3984a3d17f83
                      rateLimit:
                        limit: 10
                        remaining: 9
                        resetSeconds: 1
        '401':
          $ref: '#/components/schemas/ErrorResponse'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiError'
              examples:
                missingBearer:
                  summary: Missing Bearer token
                  value:
                    error:
                      code: 401
                      key: auth.missing_bearer
                      message: Authorization Bearer token is required.
                    meta:
                      requestId: 4f849d7d-f4f1-45cc-b4b7-3984a3d17f83
                      rateLimit:
                        limit: 10
                        remaining: 9
                        resetSeconds: 1
                invalidToken:
                  summary: Invalid or expired token
                  value:
                    error:
                      code: 401
                      key: auth.invalid_token
                      message: The access token is invalid or expired.
                    meta:
                      requestId: 4f849d7d-f4f1-45cc-b4b7-3984a3d17f83
                      rateLimit:
                        limit: 10
                        remaining: 9
                        resetSeconds: 1
                invalidClient:
                  summary: Inactive or revoked client
                  value:
                    error:
                      code: 401
                      key: auth.invalid_client
                      message: The Public API client is inactive or revoked.
                    meta:
                      requestId: 4f849d7d-f4f1-45cc-b4b7-3984a3d17f83
                      rateLimit:
                        limit: 10
                        remaining: 9
                        resetSeconds: 1
        '403':
          $ref: '#/components/schemas/ErrorResponse'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiError'
              examples:
                insufficientScopes:
                  summary: Missing required scope
                  value:
                    error:
                      code: 403
                      key: scopes.insufficient
                      message: The access token does not include the required scope.
                      details:
                        requiredScopes:
                          - workout_progress:read
                    meta:
                      requestId: 4f849d7d-f4f1-45cc-b4b7-3984a3d17f83
                      rateLimit:
                        limit: 10
                        remaining: 9
                        resetSeconds: 1
        '404':
          description: Exercise not found / not visible (`EXERCISE_NOT_FOUND`).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiError'
              examples:
                notFound:
                  summary: Resource not found
                  value:
                    error:
                      code: 404
                      key: resource.not_found
                      message: The requested Public API resource was not found.
                    meta:
                      requestId: 4f849d7d-f4f1-45cc-b4b7-3984a3d17f83
                      rateLimit:
                        limit: 10
                        remaining: 9
                        resetSeconds: 1
        '409':
          $ref: '#/components/schemas/ErrorResponse'
        '422':
          $ref: '#/components/schemas/ErrorResponse'
        '429':
          $ref: '#/components/schemas/ErrorResponse'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiError'
              examples:
                rateLimitExceeded:
                  summary: Rate limit exceeded
                  value:
                    error:
                      code: 429
                      key: rate_limit.exceeded
                      message: Too many Public API requests. Retry later.
                    meta:
                      requestId: 4f849d7d-f4f1-45cc-b4b7-3984a3d17f83
                      rateLimit:
                        limit: 10
                        remaining: 0
                        resetSeconds: 1
                        retryAfterSeconds: 1
        '500':
          description: Unexpected server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiError'
              examples:
                serverInternalError:
                  summary: Unexpected server error
                  value:
                    error:
                      code: 500
                      key: server.internal_error
                      message: An unexpected Public API server error occurred.
                    meta:
                      requestId: 4f849d7d-f4f1-45cc-b4b7-3984a3d17f83
                      rateLimit:
                        limit: 10
                        remaining: 9
                        resetSeconds: 1
      security:
        - PublicBearerAuth: []
      x-codeSamples:
        - lang: cURL
          label: cURL
          source: >-
            curl -X GET
            "https://api.fitsociety.io/public/v1/workout/clients/{clientId}/library/exercises/{exerciseId}/history"
            \
              -H "Authorization: Bearer <access_token>"
components:
  schemas:
    PublicApiSuccessResponse:
      type: object
      additionalProperties: false
      required:
        - data
        - meta
      properties:
        data:
          type: object
        meta:
          $ref: '#/components/schemas/PublicApiMeta'
    PublicWorkoutSourceGETAppV1WorkoutClientLibraryExercisesExerciseIdHistoryResponse200:
      type: object
      description: >-
        Combined History + Statistics + Leaderboard (no `tab`): { exercise,
        libraryExercise, history[], pagination, statistics, filters,
        leaderboard, paginationLeaderboard }.
      properties:
        exercise:
          type: object
          description: Same Information-tab object as the exercise detail response.
          properties:
            _id:
              type: string
              example: 67f1234567890abcdef1234
            name:
              type: string
              example: Dumbbell Bench Press
            description:
              type: string
            defaultType:
              type: string
              enum:
                - ''
                - reps
                - time
                - distance
              example: ''
              description: Freestyle measurement fallback; `""` = legacy reps inference.
            media:
              type: array
              items:
                $ref: >-
                  #/components/schemas/PublicWorkoutSourceWorkoutExerciseSearchMedia
            targetedMuscles:
              type: array
              items:
                type: string
            primaryCategory:
              type: string
            secondaryCategories:
              type: array
              items:
                type: string
            equipment:
              type: array
              items:
                type: string
            difficulty:
              type: string
            intensity:
              type: string
            tags:
              type: array
              items:
                type: string
            muscleActivation:
              type: object
              description: Static library muscle activation for the body visual.
              properties:
                total:
                  type: object
                  properties:
                    normalized:
                      type: object
                      additionalProperties:
                        type: number
                    maxValue:
                      type: number
                      example: 1
            muscleBalance:
              type: array
              description: Radar chart muscle-balance values.
              items:
                type: object
                properties:
                  muscle:
                    type: string
                    example: Arms
                  value:
                    type: number
                    example: 1
                  normalized:
                    type: number
                    example: 1
            isFavourite:
              type: boolean
              example: false
            isClientOwn:
              type: boolean
              example: false
              description: >-
                Whether the requesting client (or, for a coach caller, the
                target `clientId`) created this exercise — addedBy === clientId
                with the Client role. Coach/company/system exercises → false.
        libraryExercise:
          $ref: '#/components/schemas/PublicWorkoutSourceWorkoutLibraryExercise'
        history:
          type: array
          description: >-
            Dated performance entries with plan context and per-set rows.
            `startedAt` is UTC; clients format the displayed time in the
            viewer's timezone.
          items:
            type: object
            properties:
              performanceId:
                type: string
                example: 67f1234567890abcdef1234
              sessionId:
                allOf:
                  - type: string
                    example: 67f1234567890abcdef1234
              isPersonalRecord:
                type: boolean
                example: false
                description: >-
                  Performance-level PR flag — mirrors this performance's single
                  record set (its heaviest completed set that is a top-3
                  record).
              prVerified:
                type: boolean
                example: false
                description: >-
                  Filled (current standing record, prRank 1) vs outlined (older
                  record, prRank 2/3). Mirrors the record set.
              prRank:
                type:
                  - integer
                  - 'null'
                enum:
                  - 1
                  - 2
                  - 3
                  - null
                example: null
                description: >-
                  Record rank of this performance's PR set (1–3), or `null` when
                  it has no top-3 record.
              planId:
                type:
                  - string
                  - 'null'
                description: >-
                  Assigned plan id; `null` for freestyle or unlinked
                  performances.
              planMomentId:
                type:
                  - string
                  - 'null'
                description: >-
                  Plan day (moment) id; `null` for freestyle or unlinked
                  performances.
              exerciseId:
                type:
                  - string
                  - 'null'
                description: The performed exercise's id.
              planExerciseId:
                type:
                  - string
                  - 'null'
                description: >-
                  The plan-day exercise slot id; `null` for freestyle or ad-hoc
                  performances.
              executionContext:
                type:
                  - object
                  - 'null'
                description: >-
                  Immutable rest and grouping context captured for this
                  performance. Use this instead of the current plan when
                  displaying historical rest; legacy performances return null.
                properties:
                  mode:
                    type: string
                    enum:
                      - standalone
                      - superset
                    example: superset
                  groupId:
                    type: string
                    example: superset-bench-row
                  restSeconds:
                    type:
                      - number
                      - 'null'
                    minimum: 0
                    example: 90
                  restSource:
                    type: string
                    enum:
                      - exercise
                      - superset
                    example: superset
              planName:
                type:
                  - string
                  - 'null'
                example: 30-Day High Intensity Belly Burn
                description: >-
                  Localized assigned plan name; `null` for freestyle or when the
                  historical plan is unavailable.
              type:
                type: string
                enum:
                  - reps
                  - time
                  - distance
                  - bodyweight
                  - weighted_bodyweight
                  - assisted_bodyweight
                example: reps
                description: Resolved tracking type for this performance occurrence.
              scheduleMode:
                type: string
                enum:
                  - recurring
                  - multi_week
                  - freestyle
                example: multi_week
                description: >-
                  This entry's context: `freestyle` for a non-plan log,
                  otherwise the plan's `schedule.mode`.
              weekNumber:
                type:
                  - integer
                  - 'null'
                minimum: 1
                example: 2
                description: >-
                  The 1-based programme week for a `multi_week` entry; `null`
                  for `recurring` and `freestyle`. The matching numeric weekday
                  (1 = Monday … 7 = Sunday) is returned in `weekday` for
                  `multi_week` entries.
              dayName:
                type: string
                example: Day A — Upper Body
                description: >-
                  The plan day (moment) name for a plan entry; `""` for a
                  freestyle entry.
              freestyleName:
                type: string
                example: Freestyle Workout 7
                description: >-
                  The freestyle session's name — the client's own name, else
                  `Freestyle Workout N` (same numbering as the freestyle history
                  feed). `""` for a plan entry.
              targets:
                type:
                  - object
                  - 'null'
                properties:
                  type:
                    type: string
                  sets:
                    type:
                      - integer
                      - 'null'
                  reps:
                    type:
                      - string
                      - number
                      - 'null'
                  rest:
                    type:
                      - number
                      - 'null'
                  rpe:
                    type:
                      - number
                      - 'null'
                  rmPercentage:
                    type:
                      - number
                      - 'null'
                  tempo:
                    type:
                      - string
                      - 'null'
                  notes:
                    type:
                      - string
                      - 'null'
                additionalProperties: false
              date:
                type: string
                format: date-time
              startedAt:
                type:
                  - string
                  - 'null'
                format: date-time
                example: '2026-01-09T07:32:00.000Z'
                description: >-
                  Performance start instant in UTC; format it on the client for
                  display.
              dateLabel:
                type: string
                example: 09 Jan 2026
              weekday:
                oneOf:
                  - type: string
                    example: Monday
                  - type:
                      - integer
                      - 'null'
                    minimum: 1
                    maximum: 7
                description: >-
                  At the day-group level this is the weekday NAME (e.g.
                  `"Monday"`). On a `multi_week` plan entry it is the numeric
                  weekday (1 = Monday … 7 = Sunday); `null`/absent for
                  `recurring` and `freestyle` entries.
              isCompleted:
                type: boolean
                example: true
              setCount:
                type: integer
                example: 4
              sets:
                type: array
                items:
                  type: object
                  properties:
                    setNumber:
                      type: integer
                      example: 1
                    setType:
                      type: string
                      enum:
                        - 'N'
                        - W
                        - D
                        - F
                      example: W
                    rest:
                      type:
                        - number
                        - 'null'
                      example: 10
                    reps:
                      type:
                        - number
                        - 'null'
                      example: 15
                    weight:
                      type:
                        - number
                        - 'null'
                      example: 15
                    timeSeconds:
                      type:
                        - number
                        - 'null'
                    distanceMeters:
                      type:
                        - number
                        - 'null'
                    rpe:
                      type:
                        - number
                        - 'null'
                    completed:
                      type: boolean
                      example: true
                    isPersonalRecord:
                      type: boolean
                      example: false
                      description: >-
                        True only for a COMPLETED set that is one of the
                        exercise's 3 most-recent records.
                    prVerified:
                      type: boolean
                      example: false
                      description: >-
                        Filled badge (current standing record, prRank 1) when
                        true; outlined badge (an older, since-beaten record —
                        prRank 2 or 3) when false.
                    prRank:
                      type:
                        - integer
                        - 'null'
                      enum:
                        - 1
                        - 2
                        - 3
                        - null
                      example: 1
                      description: >-
                        Record rank across the exercise's history: 1 = current
                        standing record ("PR 1"), 2/3 = older records since
                        beaten. Capped at 3 — the 4th-oldest record and beyond
                        get no badge. `null` when the set is not a PR.
                    repsPlaceholderCoach:
                      type:
                        - number
                        - string
                        - 'null'
                      example: 10
                      description: >-
                        The coach's prescribed hint for an empty reps input on
                        this set (the plan's per-set prescription). A range
                        string (`"8-12"`) is allowed. `null` when this exercise
                        type does not track reps, nothing is prescribed, or the
                        entry is freestyle.
                    weightPlaceholderCoach:
                      type:
                        - number
                        - 'null'
                      example: 40
                    timeSecondsPlaceholderCoach:
                      type:
                        - number
                        - 'null'
                      example: null
                    distanceMetersPlaceholderCoach:
                      type:
                        - number
                        - 'null'
                      example: null
                    rpePlaceholderCoach:
                      type:
                        - number
                        - 'null'
                      example: 7
                    restSecondsPlaceholderCoach:
                      type:
                        - number
                        - 'null'
                      example: 90
                    repsPlaceholder:
                      type:
                        - number
                        - string
                        - 'null'
                      example: 10
                      description: >-
                        The hint to actually show. The coach's
                        `repsPlaceholderCoach` wins wherever it exists;
                        otherwise the client's own stored placeholder (the only
                        source for a freestyle entry).
                    weightPlaceholder:
                      type:
                        - number
                        - 'null'
                      example: 40
                    timeSecondsPlaceholder:
                      type:
                        - number
                        - 'null'
                      example: null
                    distanceMetersPlaceholder:
                      type:
                        - number
                        - 'null'
                      example: null
                    rpePlaceholder:
                      type:
                        - number
                        - 'null'
                      example: 7
                    restSecondsPlaceholder:
                      type:
                        - number
                        - 'null'
                      example: 90
                    repsActual:
                      type:
                        - number
                        - string
                        - 'null'
                      example: 30
                      description: >-
                        The athlete's ACTUALLY-logged reps for this set (mirrors
                        `reps`), or `null` when they did not log it. Additive:
                        `reps` is unchanged.
                    weightActual:
                      type:
                        - number
                        - 'null'
                      example: 42
                      description: Actually-logged weight (mirrors `weight`), or `null`.
                    timeSecondsActual:
                      type:
                        - number
                        - 'null'
                      example: null
                      description: Actually-logged time (mirrors `timeSeconds`), or `null`.
                    distanceMetersActual:
                      type:
                        - number
                        - 'null'
                      example: null
                      description: >-
                        Actually-logged distance (mirrors `distanceMeters`), or
                        `null`.
                    rpeActual:
                      type:
                        - number
                        - 'null'
                      example: 8
                      description: Actually-logged RPE (mirrors `rpe`), or `null`.
                    restSecondsActual:
                      type:
                        - number
                        - 'null'
                      example: 90
                      description: Actually-logged rest (mirrors `restSeconds`), or `null`.
        muscleActivation:
          type: object
          description: >-
            Muscle activation for THIS exercise across its ALL-TIME completed
            history (plan + freestyle) — same block shape as the workout history
            response, stable across pages. Activation concentrates on the
            exercise's primary and secondary muscles.
          properties:
            range:
              type: object
              description: >-
                Span of the exercise's logged history (first → last
                performance); both null when there is none.
              properties:
                startDate:
                  type: string
                  format: date-time
                  nullable: true
                endDate:
                  type: string
                  format: date-time
                  nullable: true
            total:
              type: object
              properties:
                normalized:
                  type: object
                  description: Per-muscle activation, normalized; keyed by muscle group.
                  additionalProperties:
                    type: number
                maxValue:
                  type: number
                  example: 320
                topMuscles:
                  type: array
                  items:
                    $ref: >-
                      #/components/schemas/PublicWorkoutSourceWorkoutMuscleActivationTop
                  description: Top-activated muscles, strongest first.
        pagination:
          type: object
          description: History pagination.
          properties:
            page:
              type: integer
              example: 1
            limit:
              type: integer
              example: 10
            totalPages:
              type: integer
              example: 8
            totalItems:
              type: integer
              example: 78
            hasNextPage:
              type: boolean
              example: true
            hasPreviousPage:
              type: boolean
              example: false
            nextPage:
              type:
                - integer
                - 'null'
              example: 2
            previousPage:
              type:
                - integer
                - 'null'
              example: null
            totalAvailableItems:
              type: integer
              minimum: 0
              description: >-
                Total matching records before the shared catalogue browse
                boundary.
        statistics:
          type: object
          description: Statistics for the selected `statsRange`.
          properties:
            cards:
              type: object
              properties:
                timesPerformed:
                  type: integer
                  example: 78
                totalSets:
                  type: integer
                  example: 456
                totalReps:
                  type: integer
                  example: 187
                frequencyPerWeek:
                  type: number
                  example: 2
            chart:
              type: object
              description: >-
                Drawer-ready graph. `metric` determines which type-specific
                value the frontend charts; do not infer its unit or direction
                from the exercise name.
              properties:
                metric:
                  type: object
                  properties:
                    key:
                      type: string
                      enum:
                        - reps
                        - weight
                        - assistance
                        - time
                        - distance
                      example: reps
                    label:
                      type: string
                      example: Reps
                    unit:
                      type: string
                      enum:
                        - reps
                        - kg
                        - s
                        - m
                      example: reps
                    exerciseType:
                      type: string
                      enum:
                        - reps
                        - time
                        - distance
                        - bodyweight
                        - weighted_bodyweight
                        - assisted_bodyweight
                    aggregation:
                      type: string
                      enum:
                        - max
                        - min
                        - sum
                    direction:
                      type: string
                      enum:
                        - higher
                        - lower
                granularity:
                  type: string
                  example: day
                range:
                  type: object
                  properties:
                    startDate:
                      type: string
                      format: date-time
                    endDate:
                      type: string
                      format: date-time
                    startDateLabel:
                      type: string
                      example: 07-28-2026
                    endDateLabel:
                      type: string
                      example: 08-20-2026
                summary:
                  type: object
                  properties:
                    minimum:
                      type:
                        - number
                        - 'null'
                    average:
                      type:
                        - number
                        - 'null'
                    maximum:
                      type:
                        - number
                        - 'null'
                points:
                  type: array
                  items:
                    type: object
                    properties:
                      date:
                        type: string
                        format: date-time
                      dateLabel:
                        type: string
                        example: 07-28-2026
                      value:
                        type:
                          - number
                          - 'null'
                        description: >-
                          Primary chart value. Assistance uses the minimum
                          completed nonnegative assistance with positive reps in
                          each bucket. Buckets without a qualifying set are
                          omitted from chart.points, while real zero-assistance
                          points are retained. Use metric.direction=lower and
                          metric.aggregation=min.
                      label:
                        type: string
                        example: '2026-01-09'
                      weight:
                        type:
                          - number
                          - 'null'
                        example: 38.35
                      volume:
                        type: number
                        example: 298.6
                      oneRm:
                        type: number
                        example: 36.8
                      weightPer:
                        type:
                          - number
                          - 'null'
                        example: 12.4
                      volumePer:
                        type: number
                        example: 8.7
                      oneRmPer:
                        type: number
                        example: 10.1
                      reps:
                        type: number
                        example: 12
                      timeSeconds:
                        type: number
                        example: 900
                      distanceMeters:
                        type: number
                        example: 1500
                previousRecords:
                  type: array
                  maxItems: 10
                  description: >-
                    Most recent completed exercise performances using the
                    selected graph metric.
                  items:
                    type: object
                    properties:
                      performanceId:
                        type: string
                        example: 67f1234567890abcdef1234
                      date:
                        type: string
                        format: date-time
                      dateLabel:
                        type: string
                        example: 08-20-2026
                      value:
                        type: number
                        example: 12
            personalRecords:
              type: object
              properties:
                maxWeight:
                  type: object
                  properties:
                    value:
                      type: number
                      example: 40
                    unit:
                      type: string
                      example: kg
                    achievedAt:
                      type: string
                      format: date-time
                estimated1RM:
                  type: object
                  properties:
                    value:
                      type: number
                      example: 46.5
                    unit:
                      type: string
                      example: kg
                    achievedAt:
                      type: string
                      format: date-time
                maxSetVolume:
                  type: object
                  properties:
                    value:
                      type: number
                      example: 320
                    unit:
                      type: string
                      example: kg
                    achievedAt:
                      type: string
                      format: date-time
                maxSessionVolume:
                  type: object
                  properties:
                    value:
                      type: number
                      example: 1280
                    unit:
                      type: string
                      example: kg
                    achievedAt:
                      type: string
                      format: date-time
        filters:
          type: object
          properties:
            availableFilters:
              type: object
              properties:
                statsRange:
                  type: array
                  items:
                    type: object
                    properties:
                      value:
                        type: string
                        example: last7days
                      label:
                        type: string
                        example: Last 7 days
                leaderboardMetric:
                  type: array
                  description: >-
                    The 5 leaderboard metric-selector options (drives the
                    leaderboard tab's metric dropdown).
                  items:
                    type: object
                    properties:
                      value:
                        type: string
                        enum:
                          - maxWeight
                          - totalReps
                          - totalTimeSeconds
                          - estimated1RM
                          - totalVolume
                        example: totalTimeSeconds
                      label:
                        type: string
                        example: Time
                      unit:
                        type: string
                        example: h
            selectedFilters:
              type: object
              properties:
                statsRange:
                  type: string
                  example: last7days
                leaderboardMetric:
                  type: string
                  example: maxWeight
                  description: >-
                    Currently-selected leaderboard metric (echoes
                    `leaderboardMetric` query).
        leaderboard:
          type: object
          description: >-
            Leaderboard tab for this exercise. Self-gated by the company
            leaderboard config (`enabled`) and the client's visibility
            (`hidden`). Scoped to the exercise across the company.
          properties:
            enabled:
              type: boolean
              example: true
              description: '`false` when the company leaderboard is off.'
            hidden:
              type: boolean
              example: false
              description: '`true` when the client hid themselves from leaderboards.'
            metric:
              type: string
              enum:
                - maxWeight
                - totalReps
                - totalTimeSeconds
                - estimated1RM
                - totalVolume
              example: maxWeight
              description: The selected metric (echoes `leaderboardMetric`).
            calculationMode:
              type: string
              example: absolute
            scoreUnit:
              type:
                - string
                - 'null'
              example: kg
              description: '`kg` | `reps` | `h` (time). Matches `displayValue`''s unit.'
            scoreDirection:
              type: string
              example: desc
            podium:
              type: array
              description: >-
                The top 3 by score (always, independent of page). EXCLUDED from
                `data` — the list starts at rank 4 so the top 3 are never
                repeated. (The metric-selector options moved to
                `filters.availableFilters.leaderboardMetric`.)
              items:
                type: object
                properties:
                  rank:
                    type: integer
                    example: 4
                  clientId:
                    type: string
                    example: 67f1234567890abcdef1234
                  firstName:
                    type: string
                    example: Ann
                  lastName:
                    type: string
                    example: Saris
                  name:
                    type: string
                    example: Ann Saris
                  image:
                    type: string
                    example: https://cdn.example.com/clients/ann.jpg
                  value:
                    type:
                      - number
                      - 'null'
                    example: 180
                  displayScore:
                    type:
                      - number
                      - 'null'
                    example: 180
                  displayValue:
                    type: string
                    example: 180 kg
                    description: >-
                      Preformatted score: "HH:MM h" for time (e.g. "01:24 h"),
                      "N kg" for weight/1RM/volume, "N reps" for reps.
                  scoreUnit:
                    type:
                      - string
                      - 'null'
                    example: kg
                    description: '`kg` | `reps` | `h`.'
                  verificationStatus:
                    type: string
                    enum:
                      - verified
                      - pending
                      - unverified
                    example: verified
                    description: 'Badge: ✓ verified / ⏳ pending / — unverified.'
                  anonymousAvatar:
                    type: boolean
                    example: false
                  isCurrentUser:
                    type: boolean
                    example: false
            data:
              type: array
              description: >-
                Paginated leaderboard slice BELOW the podium — starts at rank 4
                on page 1 (the top 3 live in `podium` and are never repeated
                here).
              items:
                type: object
                properties:
                  rank:
                    type: integer
                    example: 4
                  clientId:
                    type: string
                    example: 67f1234567890abcdef1234
                  firstName:
                    type: string
                    example: Ann
                  lastName:
                    type: string
                    example: Saris
                  name:
                    type: string
                    example: Ann Saris
                  image:
                    type: string
                    example: https://cdn.example.com/clients/ann.jpg
                  value:
                    type:
                      - number
                      - 'null'
                    example: 180
                  displayScore:
                    type:
                      - number
                      - 'null'
                    example: 180
                  displayValue:
                    type: string
                    example: 180 kg
                    description: >-
                      Preformatted score: "HH:MM h" for time (e.g. "01:24 h"),
                      "N kg" for weight/1RM/volume, "N reps" for reps.
                  scoreUnit:
                    type:
                      - string
                      - 'null'
                    example: kg
                    description: '`kg` | `reps` | `h`.'
                  verificationStatus:
                    type: string
                    enum:
                      - verified
                      - pending
                      - unverified
                    example: verified
                    description: 'Badge: ✓ verified / ⏳ pending / — unverified.'
                  anonymousAvatar:
                    type: boolean
                    example: false
                  isCurrentUser:
                    type: boolean
                    example: false
            currentUser:
              description: >-
                The current client's own row, ALWAYS returned and pinned
                statically (even when off the current page); `null` when the
                client has no entry. `inCurrentPage` = whether it also appears
                in `data` (false when the client is in the podium).
              oneOf:
                - allOf:
                    - type: object
                      properties:
                        rank:
                          type: integer
                          example: 4
                        clientId:
                          type: string
                          example: 67f1234567890abcdef1234
                        firstName:
                          type: string
                          example: Ann
                        lastName:
                          type: string
                          example: Saris
                        name:
                          type: string
                          example: Ann Saris
                        image:
                          type: string
                          example: https://cdn.example.com/clients/ann.jpg
                        value:
                          type:
                            - number
                            - 'null'
                          example: 180
                        displayScore:
                          type:
                            - number
                            - 'null'
                          example: 180
                        displayValue:
                          type: string
                          example: 180 kg
                          description: >-
                            Preformatted score: "HH:MM h" for time (e.g. "01:24
                            h"), "N kg" for weight/1RM/volume, "N reps" for
                            reps.
                        scoreUnit:
                          type:
                            - string
                            - 'null'
                          example: kg
                          description: '`kg` | `reps` | `h`.'
                        verificationStatus:
                          type: string
                          enum:
                            - verified
                            - pending
                            - unverified
                          example: verified
                          description: 'Badge: ✓ verified / ⏳ pending / — unverified.'
                        anonymousAvatar:
                          type: boolean
                          example: false
                        isCurrentUser:
                          type: boolean
                          example: false
                    - type: object
                      properties:
                        inCurrentPage:
                          type: boolean
                          example: true
                - type: 'null'
            totalParticipants:
              type: integer
              example: 156
        paginationLeaderboard:
          type: object
          description: >-
            Leaderboard pagination. totalItems counts participants excluding the
            top-three podium, and totalPages applies to that paginated list.
          properties:
            page:
              type: integer
              example: 1
            limit:
              type: integer
              example: 10
            totalPages:
              type: integer
              example: 16
            totalItems:
              type: integer
              example: 153
            hasNextPage:
              type: boolean
              example: true
            hasPreviousPage:
              type: boolean
              example: false
            nextPage:
              oneOf:
                - type: integer
                - type: boolean
              example: 2
              description: Next page number, or `false` on the last page.
            previousPage:
              oneOf:
                - type: integer
                - type: boolean
              example: false
            totalAvailableItems:
              type: integer
              minimum: 0
              description: >-
                Total matching records before the shared catalogue browse
                boundary.
    PublicApiError:
      type: object
      additionalProperties: false
      required:
        - error
        - meta
      properties:
        error:
          type: object
          additionalProperties: false
          required:
            - code
            - key
            - message
          properties:
            code:
              type: integer
              example: 401
            key:
              type: string
              example: auth.invalid_token
            message:
              type: string
              example: The access token is invalid.
            details:
              type: object
              additionalProperties: true
        meta:
          $ref: '#/components/schemas/PublicApiMeta'
    ErrorResponse:
      allOf:
        - $ref: '#/components/schemas/StandardResponse'
        - example:
            status: 401
            error: true
            message: MISSING_AUTH
    PublicApiMeta:
      type: object
      additionalProperties: false
      required:
        - requestId
      properties:
        requestId:
          type: string
          description: Stable request correlation id. Mirrors `X-Request-Id` when supplied.
          example: 4f849d7d-f4f1-45cc-b4b7-3984a3d17f83
        rateLimit:
          $ref: '#/components/schemas/PublicApiRateLimitMeta'
    PublicWorkoutSourceWorkoutExerciseSearchMedia:
      type: object
      properties:
        type:
          type: string
          enum:
            - image
            - video
          example: image
        url:
          type: string
          example: https://cdn.example.com/exercises/bench.jpg
        platform:
          type:
            - string
            - 'null'
          enum:
            - null
            - s3
            - youtube
            - tiktok
          example: null
        videoId:
          type:
            - string
            - 'null'
          example: null
        thumbnail:
          type:
            - string
            - 'null'
          example: null
        duration:
          type:
            - number
            - 'null'
          example: null
        width:
          type:
            - number
            - 'null'
          example: 1280
        height:
          type:
            - number
            - 'null'
          example: 720
    PublicWorkoutSourceWorkoutLibraryExercise:
      type: object
      properties:
        primaryMuscle:
          type: string
          example: Chest
        description:
          type: string
          description: Localized catalog exercise description.
          example: Flat horizontal press with controlled tempo.
        secondaryMuscles:
          type: array
          items:
            type: string
            enum:
              - Chest
              - Back
              - Lats
              - Traps
              - Shoulders
              - Biceps
              - Triceps
              - Forearms
              - Core
              - Abs
              - Obliques
              - Glutes
              - Quads
              - Hamstrings
              - Calves
              - Adductors
              - Abductors
              - Hip Flexors
              - Full Body
              - Cardio / Conditioning
              - Neck
              - Lower Back
          example:
            - Shoulders
            - Triceps
        primaryJoint:
          type: string
          enum:
            - ''
            - Ankle
            - Combination
            - Core
            - Elbow
            - Fingers
            - Hip
            - Knee
            - Neck
            - Shoulder
            - Spine
            - Wrist
          example: Shoulder
        difficulty:
          type: string
          enum:
            - ''
            - Beginner
            - Intermediate
            - Advanced
          example: Intermediate
        intensity:
          type: string
          enum:
            - ''
            - Beginner
            - Below Average
            - Average
            - Above Average
            - High Intensity
          example: Above Average
        equipment:
          type: array
          items:
            type: string
            enum:
              - Dumbbells
              - AdjustableDumbbells
              - Kettlebell
              - AdjustableKettlebell
              - CompetitionKettlebell
              - Medicineball
              - SlamBall
              - WallBall
              - Weightplate
              - BumperPlates
              - FractionalPlates
              - LoadableDumbbellHandle
              - Sandbag
              - StrongmanSandbag
              - Bulgarianbag
              - Aquabag
              - Aquaball
              - Hydrovest
              - MagneticBell
              - Macebell
              - SteelClub
              - IndianClub
              - Barbell
              - OlympicBarbell
              - TechniqueBar
              - EZBar
              - TrapBar
              - SafetySquatBar
              - SwissBar
              - CamberedBar
              - AxleBar
              - Landmine
              - Bench
              - FlatBench
              - AdjustableBench
              - InclineBench
              - DeclineBench
              - SealRowBench
              - HipThrustBench
              - BenchPressRack
              - SquatRack
              - SquatStand
              - PowerRack
              - WallMountedRack
              - HalfRack
              - SmithMachine
              - Monolift
              - JammerArms
              - BarbellJack
              - WeightTree
              - PlateStorage
              - DeadliftPlatform
              - Rig
              - StrengthMachinesPlateloaded
              - StrengthMachinesWeightstack
              - StrengthMachinesPneumatic
              - MultiGym
              - LegPressMachine
              - VerticalLegPressMachine
              - LeverageSquatMachine
              - LinearHackSquatMachine
              - BeltSquatMachine
              - PendulumSquatMachine
              - VSquatMachine
              - HackSquatMachine
              - LegExtensionMachine
              - LegCurlMachine
              - SeatedLegCurlMachine
              - LyingLegCurlMachine
              - StandingLegCurlMachine
              - StandingCalfRaiseMachine
              - SeatedCalfRaiseMachine
              - CalfPressMachine
              - HipThrustMachine
              - GluteDriveMachine
              - GluteKickbackMachine
              - HipExtensionMachine
              - HipAbductionMachine
              - HipAdductionMachine
              - ChestPressMachine
              - VerticalChestPressMachine
              - InclineChestPressMachine
              - DeclineChestPressMachine
              - IsoLateralChestPressMachine
              - IsoLateralInclinePressMachine
              - ShoulderPressMachine
              - IsoLateralShoulderPressMachine
              - MultiPressMachine
              - LateralRaiseMachine
              - RearDeltMachine
              - PecDeckMachine
              - PulloverMachine
              - LatPulldownMachine
              - IsoLateralLatPulldownMachine
              - AssistedPullupMachine
              - AssistedDipMachine
              - SeatedDipMachine
              - SeatedRowMachine
              - LowRowMachine
              - HighRowMachine
              - IsoLateralRowMachine
              - ChestSupportedRowMachine
              - TBarRowMachine
              - BicepsCurlMachine
              - PreacherCurlMachine
              - TricepsExtensionMachine
              - AbCrunchMachine
              - AbCoasterMachine
              - RotaryTorsoMachine
              - BackExtensionMachine
              - SeatedBackExtensionMachine
              - HyperextensionBench
              - ReverseHyper
              - GHD
              - Kinesis
              - Pulley
              - CableMachine
              - CableStation
              - CableColumn
              - CableCrossover
              - DualAdjustablePulley
              - SingleCableTower
              - FunctionalTrainer
              - TotalGymGTS
              - Gymstick
              - ViPR
              - RipTrainer
              - Battlerope
              - ProwlerSled
              - FarmersHandles
              - Yoke
              - Tire
              - Sledgehammer
              - TorqueTank
              - SledTrack
              - WallBallTarget
              - AgilityPoles
              - MiniHurdles
              - SprintParachute
              - PullUpBar
              - Parallelbars
              - DipBars
              - Equalizer
              - Suspensiontrainer
              - SuspensionSlingTrainer
              - GymnasticRings
              - MonkeyBars
              - PegBoard
              - RopeClimb
              - Wall
              - StallBars
              - DoorPullUpBar
              - PushUpHandles
              - AbStraps
              - Boxstep
              - SoftPlyoBox
              - Hurdle
              - Speedladder
              - Parallettes
              - NordicBench
              - SissySquatBench
              - Cardio
              - Treadmill
              - CurvedTreadmill
              - AirRunner
              - AssaultRunner
              - StationaryBike
              - UprightBike
              - RecumbentBike
              - BikeErg
              - SpinBike
              - AirBike
              - Rower
              - WaterRower
              - FanRower
              - ArmErgometer
              - SkiErg
              - Elliptical
              - ArcTrainer
              - NuStep
              - StairClimber
              - StepMill
              - JacobsLadder
              - VersaClimber
              - Bosu
              - Balanceball
              - Exerciseball
              - PilatesTennisball
              - PilatesRing
              - YogaMat
              - YogaBlock
              - YogaWheel
              - StretchStrap
              - MobilityStick
              - MassageBall
              - PeanutMassageBall
              - Airpad
              - Balanceboard
              - BalancePad
              - WobbleBoard
              - Glidedisc
              - Foamroller
              - Elasticbands
              - TherapyBand
              - Resistanceband
              - MiniBand
              - PullUpAssistBand
              - Powertube
              - AnkleWeights
              - SlantBoard
              - Vibrationtraining
              - CableRope
              - StraightBarAttachment
              - CurlBarAttachment
              - LatBarAttachment
              - TricepsBarAttachment
              - RowHandle
              - DHandle
              - DoubleDHandle
              - AnkleCuff
              - CableCuff
              - LandmineHandle
              - MagGripAttachment
              - DipBelt
              - AbWheel
              - WristRoller
              - FatGrip
              - Chain
              - DoorAnchor
              - JumpRope
              - SpeedRope
              - WeightedJumpRope
              - SledHarness
              - LiftingStraps
              - LiftingHooks
              - WristWraps
              - WeightliftingBelt
              - Clubbel
              - Stick
              - Bodybow
              - BuddySystem
              - Multinet
              - Flowin
              - Aerialhoop
              - Dancingpole
              - Trapeze
              - HulaHoop
              - Trampoline
              - XCO
              - PilatesReformer
              - PilatesChair
              - PilatesCadillac
              - PilatesBarrel
              - PilatesSpringboard
              - BalanceBeam
              - TreatmentTable
              - RehabTable
              - SlideBoard
          example:
            - Barbell
            - Bench
        images:
          type: array
          items:
            $ref: '#/components/schemas/PublicWorkoutSourceWorkoutImageAsset'
        videos:
          type: array
          items:
            $ref: '#/components/schemas/PublicWorkoutSourceWorkoutVideoAsset'
        defaultType:
          type: string
          enum:
            - ''
            - reps
            - time
            - distance
            - bodyweight
            - weighted_bodyweight
            - assisted_bodyweight
          description: Optional fallback tracking type for freestyle sessions.
          example: reps
    PublicWorkoutSourceWorkoutMuscleActivationTop:
      type: object
      required:
        - muscle
        - value
      properties:
        muscle:
          type: string
          example: chest
        value:
          type: number
          example: 18
    StandardResponse:
      type: object
      properties:
        status:
          type: integer
          example: 200
        error:
          type: boolean
          example: false
        message:
          type: string
          example: SUCCESS
      required:
        - status
        - error
        - message
    PublicApiRateLimitMeta:
      type: object
      additionalProperties: false
      properties:
        limit:
          type: integer
          example: 10
        remaining:
          type: integer
          example: 9
        resetSeconds:
          type: integer
          description: Seconds until the current rate limit window resets.
          example: 1
        retryAfterSeconds:
          type: integer
          description: Present when the request was rate limited.
          example: 1
    PublicWorkoutSourceWorkoutImageAsset:
      type: object
      required:
        - url
      properties:
        url:
          type: string
          format: uri
          example: https://cdn.example.com/workouts/plan-cover.jpg
        width:
          type:
            - number
            - 'null'
          example: 1280
        height:
          type:
            - number
            - 'null'
          example: 720
    PublicWorkoutSourceWorkoutVideoAsset:
      type: object
      required:
        - url
        - platform
      properties:
        url:
          type: string
          format: uri
          example: https://cdn.example.com/workouts/demo.mp4
        platform:
          type: string
          enum:
            - s3
            - youtube
            - tiktok
          example: s3
        videoId:
          type: string
          example: ''
        thumbnail:
          type: string
          format: uri
          example: https://cdn.example.com/workouts/demo-thumb.jpg
        duration:
          type:
            - number
            - 'null'
          example: 84
        width:
          type:
            - number
            - 'null'
          example: 1920
        height:
          type:
            - number
            - 'null'
          example: 1080
  securitySchemes:
    PublicBearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Opaque
      description: >-
        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`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.