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

# List workout v2 activity sessions with recorded metrics

> Requires the workout_progress:read scope. This operation maps to /app/v1/workout/performance/activity and retains its Workout V2 permission, feature-flag, and resource-scope checks.

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



## OpenAPI

````yaml /openapi/public-v1.json get /public/v1/workout/performance/activity
openapi: 3.1.0
info:
  title: FITsociety Public API v1
  version: 1.0.0
  description: >-
    Developer Public API endpoints under `/public/v1`. This reference is
    filtered to OAuth/Bearer Public API resources and excludes provider callback
    receivers, storefront routes, public widgets, wishlist routes, and
    access-device validation endpoints.
  contact:
    name: FITsociety Engineering
servers:
  - url: https://api.fitsociety.io
    description: Production
security: []
tags:
  - name: Workout
    description: >-
      Workout V2 libraries, programmes, client plans, calendars, sessions,
      groups, settings and progress. AI operations are excluded.
  - name: OAuth
    description: Public API OAuth endpoints for server-to-server client credentials.
  - name: Health
    description: Public API token health checks.
  - name: Platform
    description: >-
      Inspect Public API client context, capabilities, scopes, and redacted
      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 with
      guarded finance writes.
  - name: Credits
    description: >-
      Read company-wide and client-scoped credit allocations, mutations, and
      guarded credit adjustments.
  - 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.
paths:
  /public/v1/workout/performance/activity:
    get:
      tags:
        - Workout
      summary: List workout v2 activity sessions with recorded metrics
      description: >-
        Requires the workout_progress:read scope. This operation maps to
        /app/v1/workout/performance/activity and retains its Workout V2
        permission, feature-flag, and resource-scope checks.


        The clientId path parameter is resolved inside the company bound to the
        Public API token when present.
      operationId: publicWorkoutgetPublicV1WorkoutPerformanceActivity
      parameters:
        - in: query
          name: limit
          schema:
            type: integer
            minimum: 1
            maximum: 100
            example: 20
        - in: query
          name: offset
          schema:
            type: integer
            minimum: 0
            example: 0
      responses:
        '200':
          description: Paginated workout activity feed.
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/PublicApiSuccessResponse'
                  - type: object
                    properties:
                      data:
                        $ref: >-
                          #/components/schemas/PublicWorkoutSourceGETAppV1WorkoutPerformanceActivityResponse200
              examples:
                success:
                  summary: Successful response
                  value:
                    data:
                      items:
                        - id: 67f1234567890abcdef1234
                          planId: null
                          planName: 4-Day Strength Block
                          planMomentId: null
                          planMomentName: Day 1
                          status: completed
                          startedAt: '2026-04-12T10:00:00.000Z'
                          endedAt: null
                          rating: 8
                          emojiRating: 4
                          lastActivityAt: '2026-04-12T10:00:00.000Z'
                          totals:
                            totalReps: 24
                            totalTimeSeconds: 0
                            totalDistanceMeters: 0
                            totalVolume: 1680
                            maxWeight: 75
                            estimated1RM: 95
                            averageRPE: 8.2
                          performanceCount: 5
                          performances:
                            - id: 67f1234567890abcdef1234
                              exerciseId: 67f1234567890abcdef1234
                              planExerciseId: null
                              source: plan
                              name: Barbell Bench Press
                              template:
                                exerciseId: 67f1234567890abcdef1234
                                planExerciseId: null
                                sets: 3
                                minReps: 8
                                maxReps: 10
                                metric: 45 sec
                                rest: 75
                                rpe: 7
                                notes: Keep shoulder blades pinned.
                                description: Flat horizontal press with controlled tempo.
                                order: 0
                              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
                              order: 0
                              isCompleted: true
                              type: reps
                              notes: Strong final set.
                              date: '2026-04-12T10:00:00.000Z'
                              startedAt: null
                              endedAt: null
                              totals:
                                totalReps: 24
                                totalTimeSeconds: 0
                                totalDistanceMeters: 0
                                totalVolume: 1680
                                maxWeight: 75
                                estimated1RM: 95
                                averageRPE: 8.2
                              sets:
                                - setNumber: 1
                                  setType: 'N'
                                  displayNumber: 1
                                  displayLabel: '1'
                                  targetReps: 8-12
                                  targetWeight: 60
                                  targetTimeSeconds: null
                                  targetDistanceMeters: null
                                  targetRestSeconds: 90
                                  weight: 70
                                  reps: 8
                                  timeSeconds: null
                                  distanceMeters: null
                                  restSeconds: 120
                                  rpe: 8
                                  completed: true
                                  notes: Felt strong.
                                  isPersonalBest: false
                                  repsPlaceholder: 22
                                  weightPlaceholder: 30
                                  timeSecondsPlaceholder: 55
                                  distanceMetersPlaceholder: 40
                                  rpePlaceholder: 3
                                  restSecondsPlaceholder: 60
                                  repsActual: 30
                                  weightActual: 42
                                  timeSecondsActual: null
                                  distanceMetersActual: null
                                  rpeActual: 8
                                  restSecondsActual: 90
                      pagination:
                        limit: 20
                        offset: 0
                        total: 42
                        returned: 20
                    meta:
                      requestId: 4f849d7d-f4f1-45cc-b4b7-3984a3d17f83
                      rateLimit:
                        limit: 10
                        remaining: 9
                        resetSeconds: 1
        '400':
          description: Pagination or client context is invalid.
          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:
                          - required:scope
                    meta:
                      requestId: 4f849d7d-f4f1-45cc-b4b7-3984a3d17f83
                      rateLimit:
                        limit: 10
                        remaining: 9
                        resetSeconds: 1
        '404':
          $ref: '#/components/schemas/ErrorResponse'
          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/performance/activity" \
              -H "Authorization: Bearer <access_token>"
components:
  schemas:
    PublicApiSuccessResponse:
      type: object
      additionalProperties: false
      required:
        - data
        - meta
      properties:
        data:
          type: object
        meta:
          $ref: '#/components/schemas/PublicApiMeta'
    PublicWorkoutSourceGETAppV1WorkoutPerformanceActivityResponse200:
      type: object
      properties:
        items:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
                example: 67f1234567890abcdef1234
              planId:
                type:
                  - string
                  - 'null'
                example: null
              planName:
                type: string
                example: 4-Day Strength Block
              planMomentId:
                type:
                  - string
                  - 'null'
                example: null
              planMomentName:
                type: string
                example: Day 1
              status:
                type: string
                enum:
                  - planned
                  - in_progress
                  - paused
                  - completed
                  - stopped
                  - cancelled
                example: completed
              startedAt:
                type: string
                format: date-time
                example: '2026-04-12T10:00:00.000Z'
              endedAt:
                type:
                  - string
                  - 'null'
                format: date-time
                example: null
              rating:
                type:
                  - number
                  - 'null'
                example: 8
              emojiRating:
                type:
                  - number
                  - 'null'
                example: 4
              lastActivityAt:
                type: string
                format: date-time
                example: '2026-04-12T10:00:00.000Z'
              totals:
                type: object
                properties:
                  totalReps:
                    type: number
                    example: 24
                  totalTimeSeconds:
                    type: number
                    example: 0
                  totalDistanceMeters:
                    type: number
                    example: 0
                  totalVolume:
                    type: number
                    example: 1680
                  maxWeight:
                    type: number
                    example: 75
                  estimated1RM:
                    type: number
                    example: 95
                  averageRPE:
                    type: number
                    example: 8.2
              performanceCount:
                type: number
                example: 5
              performances:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                      example: 67f1234567890abcdef1234
                    exerciseId:
                      type: string
                      example: 67f1234567890abcdef1234
                    planExerciseId:
                      type:
                        - string
                        - 'null'
                      example: null
                    source:
                      type: string
                      enum:
                        - plan
                        - adhoc
                      example: plan
                    name:
                      type: string
                      example: Barbell Bench Press
                    template:
                      type:
                        - object
                        - 'null'
                      properties:
                        exerciseId:
                          type: string
                          example: 67f1234567890abcdef1234
                        planExerciseId:
                          type:
                            - string
                            - 'null'
                          example: null
                        sets:
                          type: number
                          example: 3
                        minReps:
                          type: number
                          example: 8
                        maxReps:
                          type: number
                          example: 10
                        metric:
                          type: string
                          example: 45 sec
                          description: >-
                            Plan-prescribed metric label for time or distance
                            based exercises.
                        rest:
                          type: number
                          example: 75
                        rpe:
                          type: number
                          example: 7
                        notes:
                          type: string
                          description: >-
                            Coach-prescribed note for this exercise in the plan.
                            Use `description` for the catalog exercise
                            description.
                          example: Keep shoulder blades pinned.
                        description:
                          type: string
                          description: >-
                            Localized catalog exercise description, separate
                            from the plan exercise notes.
                          example: Flat horizontal press with controlled tempo.
                        order:
                          type: number
                          example: 0
                      additionalProperties: true
                    libraryExercise:
                      oneOf:
                        - 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:
                                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
                            videos:
                              type: array
                              items:
                                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
                            defaultType:
                              type: string
                              enum:
                                - ''
                                - reps
                                - time
                                - distance
                              description: >-
                                Optional fallback tracking type for freestyle
                                sessions.
                              example: reps
                        - type: 'null'
                    order:
                      type:
                        - number
                        - 'null'
                      example: 0
                    isCompleted:
                      type: boolean
                      example: true
                    type:
                      type: string
                      enum:
                        - reps
                        - time
                        - distance
                        - mixed
                      example: reps
                    notes:
                      type: string
                      example: Strong final set.
                    date:
                      type: string
                      format: date-time
                      example: '2026-04-12T10:00:00.000Z'
                    startedAt:
                      type:
                        - string
                        - 'null'
                      format: date-time
                      example: null
                    endedAt:
                      type:
                        - string
                        - 'null'
                      format: date-time
                      example: null
                    totals:
                      type: object
                      properties:
                        totalReps:
                          type: number
                          example: 24
                        totalTimeSeconds:
                          type: number
                          example: 0
                        totalDistanceMeters:
                          type: number
                          example: 0
                        totalVolume:
                          type: number
                          example: 1680
                        maxWeight:
                          type: number
                          example: 75
                        estimated1RM:
                          type: number
                          example: 95
                        averageRPE:
                          type: number
                          example: 8.2
                    sets:
                      type: array
                      items:
                        type: object
                        required:
                          - setNumber
                        properties:
                          setNumber:
                            type: integer
                            minimum: 1
                            example: 1
                          setType:
                            type: string
                            enum:
                              - 'N'
                              - W
                              - D
                              - F
                            example: 'N'
                            description: >-
                              Planned or performed set type: N normal, W
                              warm-up, D drop set, F to failure.
                          displayNumber:
                            type:
                              - integer
                              - 'null'
                            example: 1
                            description: >-
                              Sequential number for normal sets only. Warm-up,
                              drop set, and failure sets return null.
                          displayLabel:
                            type: string
                            example: '1'
                            description: >-
                              Backend-ready display string: normal sets use
                              their sequential number, other set types use W, D,
                              or F.
                          targetReps:
                            type: string
                            example: 8-12
                          targetWeight:
                            type:
                              - number
                              - 'null'
                            minimum: 0
                            example: 60
                          targetTimeSeconds:
                            type:
                              - integer
                              - 'null'
                            minimum: 0
                            example: null
                          targetDistanceMeters:
                            type:
                              - integer
                              - 'null'
                            minimum: 0
                            example: null
                          targetRestSeconds:
                            type:
                              - integer
                              - 'null'
                            minimum: 0
                            example: 90
                          weight:
                            type:
                              - number
                              - 'null'
                            minimum: 0
                            example: 70
                          reps:
                            type:
                              - integer
                              - 'null'
                            minimum: 0
                            example: 8
                          timeSeconds:
                            type:
                              - integer
                              - 'null'
                            minimum: 0
                            example: null
                          distanceMeters:
                            type:
                              - integer
                              - 'null'
                            minimum: 0
                            example: null
                          restSeconds:
                            type:
                              - integer
                              - 'null'
                            minimum: 0
                            example: 120
                          rpe:
                            type:
                              - number
                              - 'null'
                            minimum: 0
                            maximum: 10
                            example: 8
                          completed:
                            type: boolean
                            example: true
                          notes:
                            type: string
                            example: Felt strong.
                          isPersonalBest:
                            type: boolean
                            example: false
                          repsPlaceholder:
                            type:
                              - number
                              - string
                              - 'null'
                            example: 22
                            description: >-
                              The client's OWN greyed hint for an empty reps
                              input on this set — accepted on upsert and stored
                              as sent. A range string (`"8-12"`) is allowed. It
                              is a FALLBACK, not an override: the coach's
                              `repsPlaceholderCoach` wins wherever it exists, so
                              this value is only used for sets the coach never
                              prescribed (per-set tracking off, extra sets,
                              metrics left blank). Sending it for a prescribed
                              set is accepted but has no effect. **Never logged
                              work**: placeholders are excluded from every
                              total, volume, PR and completion check, so leaving
                              a hint after clearing a value does not make the
                              set count. To COMMIT a hint the athlete accepted,
                              send it as the real `reps` value with `completed:
                              true` — but never submit a RANGE on a completed
                              set, which is stored as its minimum (`"12-24"` →
                              12) and under-credits the athlete.
                          weightPlaceholder:
                            type:
                              - number
                              - 'null'
                            minimum: 0
                            example: 30
                            description: >-
                              The client's own hint for an empty weight input.
                              See `repsPlaceholder`.
                          timeSecondsPlaceholder:
                            type:
                              - integer
                              - 'null'
                            minimum: 0
                            example: 55
                            description: >-
                              The client's own hint for an empty time input. See
                              `repsPlaceholder`.
                          distanceMetersPlaceholder:
                            type:
                              - integer
                              - 'null'
                            minimum: 0
                            example: 40
                            description: >-
                              The client's own hint for an empty distance input.
                              See `repsPlaceholder`.
                          rpePlaceholder:
                            type:
                              - number
                              - 'null'
                            minimum: 0
                            maximum: 10
                            example: 3
                            description: >-
                              The client's own hint for an empty RPE input. See
                              `repsPlaceholder`.
                          restSecondsPlaceholder:
                            type:
                              - integer
                              - 'null'
                            minimum: 0
                            example: 60
                            description: >-
                              The client's own hint for an empty rest input. See
                              `repsPlaceholder`.
                          repsActual:
                            type:
                              - number
                              - string
                              - 'null'
                            example: 30
                            description: >-
                              The athlete's ACTUALLY-logged reps for this set
                              (mirrors `reps`), or `null` when they have not
                              logged it — the visible `reps` may be a
                              coach-prescription prefill. Additive: `reps` is
                              unchanged.
                          weightActual:
                            type:
                              - number
                              - 'null'
                            minimum: 0
                            example: 42
                            description: >-
                              Actually-logged weight (mirrors `weight`), or
                              `null` if not logged. See `repsActual`.
                          timeSecondsActual:
                            type:
                              - integer
                              - 'null'
                            minimum: 0
                            example: null
                            description: >-
                              Actually-logged time (mirrors `timeSeconds`), or
                              `null` if not logged. See `repsActual`.
                          distanceMetersActual:
                            type:
                              - integer
                              - 'null'
                            minimum: 0
                            example: null
                            description: >-
                              Actually-logged distance (mirrors
                              `distanceMeters`), or `null` if not logged. See
                              `repsActual`.
                          rpeActual:
                            type:
                              - number
                              - 'null'
                            minimum: 0
                            maximum: 10
                            example: 8
                            description: >-
                              Actually-logged RPE (mirrors `rpe`), or `null` if
                              not logged or RPE is hidden. See `repsActual`.
                          restSecondsActual:
                            type:
                              - integer
                              - 'null'
                            minimum: 0
                            example: 90
                            description: >-
                              Actually-logged rest in seconds (mirrors
                              `restSeconds`), or `null` if not logged. See
                              `repsActual`.
        pagination:
          type: object
          properties:
            limit:
              type: number
              example: 20
            offset:
              type: number
              example: 0
            total:
              type: number
              example: 42
            returned:
              type: number
              example: 20
    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'
    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.