> ## 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.

# Get workout day performance history (session detail)

> Detail screen reached by tapping a completed day in the Feed tab. Assisted-bodyweight counterweights do not contribute to heaviest lift or lifted volume. Returns the full session breakdown: summary stats, muscle activation heatmap (last 7 days), ordered exercise list with planned targets, performed sets, previous-best column, superset grouping, PR flag, and session feedback.

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}/plans/workout-day-history/{sessionId}
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}/plans/workout-day-history/{sessionId}:
    get:
      tags:
        - Workout
      summary: Get workout day performance history (session detail)
      description: >-
        Detail screen reached by tapping a completed day in the Feed tab.
        Assisted-bodyweight counterweights do not contribute to heaviest lift or
        lifted volume. Returns the full session breakdown: summary stats, muscle
        activation heatmap (last 7 days), ordered exercise list with planned
        targets, performed sets, previous-best column, superset grouping, PR
        flag, and session feedback.


        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: >-
        publicWorkoutgetPublicV1WorkoutClientsClientIdPlansWorkoutDayHistorySessionId
      parameters:
        - in: path
          name: sessionId
          required: true
          description: Workout session instance id.
          schema:
            type: string
            example: 67f1234567890abcdef1234
        - in: path
          name: clientId
          required: true
          description: Client id.
          schema:
            type: string
            example: 67f1234567890abcdef1234
      responses:
        '200':
          description: Workout day performance history.
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/PublicApiSuccessResponse'
                  - type: object
                    properties:
                      data:
                        $ref: >-
                          #/components/schemas/PublicWorkoutSourceGETAppV1WorkoutPlansClientWorkoutDayHistorySessionIdClientIdResponse200
              examples:
                success:
                  summary: Successful response
                  value:
                    data:
                      sessionId: 67f1234567890abcdef1234
                      planId: 67f1234567890abcdef1234
                      planMomentId: 67f1234567890abcdef1234
                      dayName: Day A — Upper Body
                      planName: 4-Day Strength Block
                      freestyleName: Freestyle Workout 7
                      freestyleDescription: >-
                        This is your freestyle workout. Complete the exercises
                        listed below at your own pace to stay consistent and
                        track your progress. You can add or remove exercises at
                        any time.
                      isFreestyle: true
                      scheduleMode: multi_week
                      weekNumber: 2
                      weekday: 4
                      completedSessionsDate:
                        - sessionId: 67f1234567890abcdef1234
                          dayLabel: Mon
                          dateLabel: Mar 3
                          dateText: Monday, 3 March, 2026
                      summary:
                        completedDate: '2026-04-12T10:00:00.000Z'
                        totalDurationMinutes: 52
                        totalWorkouts: 14
                        totalSets: 18
                        totalReps: 144
                        heaviestLift: 102.5
                      muscleActivation:
                        range:
                          startDate: '2026-07-14T10:00:00.000Z'
                          endDate: '2026-07-14T10:00:00.000Z'
                          days: 7
                        raw: {}
                        maxValue: 320
                      exercises:
                        - type: exercise
                          planExerciseId: 67f1234567890abcdef1234
                          exerciseId: 67f1234567890abcdef1234
                          name: Dumbbell Bench Press
                          description: Example description
                          thumbnail: https://cdn.example.com/exercises/bench.jpg
                          primaryMuscle: chest
                          secondaryMuscles:
                            - string
                          equipment:
                            - string
                          groupId: ''
                          order: 0
                          isFavourite: false
                          isPersonalRecord: true
                          prVerified: true
                          prRank: 1
                          targets:
                            type: string
                            sets: 1
                            reps: string
                            rest: 1
                            rpe: 1
                            rmPercentage: 1
                            tempo: string
                            notes: string
                          previousBestSet:
                            reps: 1
                            weight: 1
                            timeSeconds: 1
                            distanceMeters: 1
                            rpe: 1
                            setNumber: 1
                          performanceId: 67f1234567890abcdef1234
                          isCompleted: true
                          notes: ''
                          clientNotes: Felt strong today.
                          clientRestSeconds: 90
                          sets:
                            - setNumber: 1
                              setType: 'N'
                              previous:
                                reps: 1
                                weight: 1
                                timeSeconds: 1
                                distanceMeters: 1
                                rpe: 1
                              reps: 15
                              weight: 20
                              timeSeconds: 1
                              distanceMeters: 1
                              restSeconds: 60
                              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
                          exerciseCount: 2
                          rounds: 3
                          data:
                            - id: 67f1234567890abcdef1234
                              name: Barbell Bench Press
                              primaryMuscle: Chest
                              secondaryMuscles:
                                - Chest
                              primaryJoint: Shoulder
                              equipment:
                                - Dumbbells
                              difficulty: Intermediate
                              intensity: Above Average
                              visibility: Company
                              tags:
                                - string
                              thumbnail: >-
                                https://cdn.example.com/exercises/bench-thumb.jpg
                      feedback:
                        rating: 8
                        emojiRating: 4
                        notes: Felt strong today.
                    meta:
                      requestId: 4f849d7d-f4f1-45cc-b4b7-3984a3d17f83
                      rateLimit:
                        limit: 10
                        remaining: 9
                        resetSeconds: 1
        '400':
          description: >-
            Missing or invalid `sessionId` or `clientId`, or company context
            missing.
          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: Session 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}/plans/workout-day-history/{sessionId}"
            \
              -H "Authorization: Bearer <access_token>"
components:
  schemas:
    PublicApiSuccessResponse:
      type: object
      additionalProperties: false
      required:
        - data
        - meta
      properties:
        data:
          type: object
        meta:
          $ref: '#/components/schemas/PublicApiMeta'
    PublicWorkoutSourceGETAppV1WorkoutPlansClientWorkoutDayHistorySessionIdClientIdResponse200:
      type: object
      properties:
        sessionId:
          type: string
          example: 67f1234567890abcdef1234
          description: The session this detail screen is for.
        planId:
          oneOf:
            - type: string
              example: 67f1234567890abcdef1234
            - type: 'null'
          description: >-
            The assigned plan this session belongs to; `null` for a freestyle
            session.
        planMomentId:
          oneOf:
            - type: string
              example: 67f1234567890abcdef1234
            - type: 'null'
          description: >-
            The plan day (moment) this session belongs to; `null` for a
            freestyle session.
        dayName:
          type: string
          example: Day A — Upper Body
        planName:
          type: string
          example: 4-Day Strength Block
        freestyleName:
          type: string
          example: Freestyle Workout 7
          description: >-
            The freestyle session's name — the client's own `displayName` when
            set, otherwise `Freestyle Workout N` in the client's language (en /
            nl / fr / de / es, English for any other language; N numbered oldest
            = 1 … newest, the same ordering the freestyle history feed uses).
            Only populated for a FREESTYLE session (no plan); empty string for
            any plan session.
        freestyleDescription:
          type: string
          example: >-
            This is your freestyle workout. Complete the exercises listed below
            at your own pace to stay consistent and track your progress. You can
            add or remove exercises at any time.
          description: >-
            The freestyle session's description — the client's own
            `displayDescription` when set, otherwise the default freestyle
            description in the client's language (en / nl / fr / de / es,
            English for any other language). Same text as the freestyle history
            feed. Only populated for a FREESTYLE session (no plan); empty string
            for any plan session.
        isFreestyle:
          type: boolean
          description: >-
            Whether this session has no assigned plan. Allows combined history
            views to apply the same freestyle display defaults.
        scheduleMode:
          type: string
          enum:
            - recurring
            - multi_week
            - freestyle
          example: multi_week
          description: >-
            The session's plan mode: `freestyle` when it has no plan, otherwise
            the plan's `schedule.mode` (`recurring` | `multi_week`), resolved
            the same way the history feed resolves it.
        weekNumber:
          type: integer
          nullable: true
          minimum: 1
          example: 2
          description: >-
            The 1-based programme week this occurrence belongs to. Only set for
            a `multi_week` session; `null` for `recurring` and `freestyle`.
        weekday:
          type: integer
          nullable: true
          minimum: 1
          maximum: 7
          example: 4
          description: >-
            The weekday this occurrence falls on (1 = Monday … 7 = Sunday). Only
            set for a `multi_week` session; `null` for `recurring` and
            `freestyle`.
        completedSessionsDate:
          type: array
          description: >-
            Every calendar date this plan day was completed on, NEWEST FIRST,
            each with the sessionId it was read from. Only populated for a
            RECURRING plan day (which can be repeated); empty for freestyle and
            multi-week sessions. Same shape/source as the programme detail
            response's `days[].completedSessionsDate`.
          items:
            type: object
            properties:
              sessionId:
                type: string
                example: 67f1234567890abcdef1234
              dayLabel:
                type: string
                example: Mon
              dateLabel:
                type: string
                example: Mar 3
              dateText:
                type: string
                example: Monday, 3 March, 2026
        summary:
          type: object
          properties:
            completedDate:
              type: string
              format: date-time
              example: '2026-04-12T10:00:00.000Z'
              nullable: true
            totalDurationMinutes:
              type: integer
              example: 52
            totalWorkouts:
              type: integer
              example: 14
              description: Total completed sessions in this plan for this client.
            totalSets:
              type: integer
              example: 18
            totalReps:
              type: integer
              example: 144
            heaviestLift:
              type: number
              example: 102.5
        muscleActivation:
          type: object
          description: Client's muscle activation aggregated over the last 7 days.
          properties:
            range:
              type: object
              properties:
                startDate:
                  type: string
                  format: date-time
                endDate:
                  type: string
                  format: date-time
                days:
                  type: integer
                  example: 7
            raw:
              type: object
              description: Activation score per muscle group.
              additionalProperties:
                type: number
            maxValue:
              type: number
              example: 320
        exercises:
          type: array
          description: >-
            Grouped exercises for the day — same shape as the day workout
            response (standalone items + superset blocks), with plan targets,
            the 'Previous' column, and per-set + exercise-level PR flags.


            On THIS endpoint each exercise's `targets` object matches the live
            execution screens exactly: for a PLAN session it carries the full
            the day workout response chip set (`type`, `sets`, `reps`, `weight`,
            `durationSeconds`, `distanceMeters`, `rest`, `rpe`, `rpeEnabled`,
            `rmPercentage`, `tempo`, `notes`, `perSetTrackingEnabled`,
            `showSetRpe`, `previous`, `previousValues[]`, `previousFields[]`);
            for a FREESTYLE session it carries the the freestyle workout
            response shape (`type` plus the other fields `null`). Superset
            blocks keep `targets: null`; their members carry it in `data[]`.
          items:
            type: object
            description: >-
              Standalone exercise (`type: "exercise"`) or a superset block
              (`type: "superset"`; member exercises in `data[]`).
            properties:
              type:
                type: string
                enum:
                  - exercise
                  - superset
                example: exercise
              planExerciseId:
                oneOf:
                  - type: string
                    example: 67f1234567890abcdef1234
                  - type: 'null'
              exerciseId:
                oneOf:
                  - type: string
                    example: 67f1234567890abcdef1234
                  - type: 'null'
              name:
                type: string
                example: Dumbbell Bench Press
              description:
                type: string
              thumbnail:
                type: string
                example: https://cdn.example.com/exercises/bench.jpg
              primaryMuscle:
                type: string
                example: chest
              secondaryMuscles:
                type: array
                items:
                  type: string
              equipment:
                type: array
                items:
                  type: string
              groupId:
                type: string
                example: ''
              order:
                type: integer
                example: 0
              isFavourite:
                type: boolean
                example: false
              isPersonalRecord:
                type: boolean
                example: true
                description: >-
                  Exercise-level PR badge: `true` when this occurrence's record
                  set beat the client's prior all-time best.
              prVerified:
                type: boolean
                example: true
                description: >-
                  The exercise's record set was completed (filled badge) vs
                  logged-but-unchecked (outline). On a superset block: `true`
                  when any member's record was completed.
              prRank:
                type:
                  - integer
                  - 'null'
                example: 1
                description: >-
                  Record number within the exercise's history: most-recent
                  record = 1 ("PR 1"), the previous record = 2, … `null` when
                  not a PR. Always `null` on superset blocks — the numbered
                  ranks stay on the member exercises in `data[]`.
              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
              previousBestSet:
                type:
                  - object
                  - 'null'
                properties:
                  reps:
                    type:
                      - number
                      - 'null'
                  weight:
                    type:
                      - number
                      - 'null'
                  timeSeconds:
                    type:
                      - number
                      - 'null'
                  distanceMeters:
                    type:
                      - number
                      - 'null'
                  rpe:
                    type:
                      - number
                      - 'null'
                  setNumber:
                    type:
                      - integer
                      - 'null'
                additionalProperties: false
              performanceId:
                oneOf:
                  - type: string
                    example: 67f1234567890abcdef1234
                  - type: 'null'
              isCompleted:
                type: boolean
                example: true
              notes:
                type: string
                example: ''
              clientNotes:
                type: string
                example: Felt strong today.
                description: >-
                  The client's own note for this performance (mirrors the day
                  workout response / the freestyle workout response). Empty
                  string when none. Always `""` on superset blocks.
              clientRestSeconds:
                type:
                  - integer
                  - 'null'
                example: 90
                description: >-
                  The client's own 'Rest time' for this performance, in seconds.
                  `null` when unset — it does NOT fall back to the plan's
                  prescribed rest. Always `null` on superset blocks.
              sets:
                type: array
                items:
                  type: object
                  properties:
                    setNumber:
                      type: integer
                      example: 1
                    setType:
                      type: string
                      enum:
                        - 'N'
                        - W
                        - D
                        - F
                      example: 'N'
                      description: Normal / Warm-up / Drop / Failure.
                    previous:
                      type:
                        - object
                        - string
                        - 'null'
                      properties:
                        reps:
                          type:
                            - number
                            - 'null'
                        weight:
                          type:
                            - number
                            - 'null'
                        timeSeconds:
                          type:
                            - number
                            - 'null'
                        distanceMeters:
                          type:
                            - number
                            - 'null'
                        rpe:
                          type:
                            - number
                            - 'null'
                      additionalProperties: false
                    reps:
                      type:
                        - number
                        - 'null'
                      example: 15
                    weight:
                      type:
                        - number
                        - 'null'
                      example: 20
                    timeSeconds:
                      type:
                        - number
                        - 'null'
                    distanceMeters:
                      type:
                        - number
                        - 'null'
                    restSeconds:
                      type:
                        - number
                        - 'null'
                      example: 60
                    rpe:
                      type:
                        - number
                        - 'null'
                    completed:
                      type: boolean
                      example: true
                    isPersonalRecord:
                      type: boolean
                      example: false
                      description: >-
                        `true` for the single record set of the occurrence — its
                        heaviest set, only when it beats the client's prior
                        all-time best.
                    prVerified:
                      type: boolean
                      example: false
                      description: >-
                        Verified PR (blue-filled tag) when the record set was
                        completed; otherwise non-verified (blue-outlined).
                    prRank:
                      type:
                        - integer
                        - 'null'
                      example: 1
                      description: >-
                        Numbered badge for the record set: most-recent record
                        across the exercise's history = 1 ("PR 1"), the previous
                        record = 2, … `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`.
              exerciseCount:
                type: integer
                example: 2
                description: 'Superset blocks only: number of member exercises.'
              rounds:
                type: integer
                example: 3
                description: 'Superset blocks only: max set count across members.'
              data:
                type: array
                description: >-
                  Superset blocks: the member exercise items (each the same
                  shape as a standalone exercise item). Empty array for
                  standalone exercises.
                items:
                  $ref: >-
                    #/components/schemas/PublicWorkoutSourceWorkoutGroupedExerciseItem
        feedback:
          type: object
          properties:
            rating:
              type: number
              nullable: true
              minimum: 1
              maximum: 10
              example: 8
            emojiRating:
              type: number
              nullable: true
              minimum: 1
              maximum: 5
              example: 4
            notes:
              type: string
              example: Felt strong today.
    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'
    PublicWorkoutSourceWorkoutGroupedExerciseItem:
      type: object
      properties:
        id:
          type: string
          example: 67f1234567890abcdef1234
        name:
          type: string
          example: Barbell Bench Press
        primaryMuscle:
          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: Chest
        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
        primaryJoint:
          type: string
          enum:
            - ''
            - Ankle
            - Combination
            - Core
            - Elbow
            - Fingers
            - Hip
            - Knee
            - Neck
            - Shoulder
            - Spine
            - Wrist
          example: Shoulder
        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
        difficulty:
          type: string
          enum:
            - ''
            - Beginner
            - Intermediate
            - Advanced
          example: Intermediate
        intensity:
          type: string
          enum:
            - ''
            - Beginner
            - Below Average
            - Average
            - Above Average
            - High Intensity
          example: Above Average
        visibility:
          type: string
          enum:
            - Everyone
            - Company
            - Fitsociety
          example: Company
        tags:
          type: array
          items:
            type: string
        thumbnail:
          type:
            - string
            - 'null'
          format: uri
          example: https://cdn.example.com/exercises/bench-thumb.jpg
    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
  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.