> ## 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 the authenticated user's last-used exercises

> Requires the workout_client_plans:read scope. This operation maps to /app/v1/workout/exercises/last-used 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/exercises/last-used
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/exercises/last-used:
    get:
      tags:
        - Workout
      summary: Get the authenticated user's last-used exercises
      description: >-
        Requires the workout_client_plans:read scope. This operation maps to
        /app/v1/workout/exercises/last-used 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: publicWorkoutgetPublicV1WorkoutExercisesLastUsed
      parameters:
        - in: query
          name: limit
          schema:
            type: integer
            minimum: 1
            maximum: 50
            example: 10
        - in: query
          name: distinct
          schema:
            type: boolean
            example: true
          description: When true, only the newest occurrence per exercise is returned.
      responses:
        '200':
          description: Most recently used exercises extracted from the user's plans.
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/PublicApiSuccessResponse'
                  - type: object
                    properties:
                      data:
                        $ref: >-
                          #/components/schemas/PublicWorkoutSourceGETAppV1WorkoutExercisesLastUsedResponse200
              examples:
                success:
                  summary: Successful response
                  value:
                    data:
                      items:
                        - exerciseId: 67f1234567890abcdef1234
                          name: Romanian Deadlift
                          primaryCategory: Strength
                          secondaryCategories:
                            - Agility & Speed
                          primaryMuscle: Hamstrings
                          secondaryMuscles:
                            - Chest
                          equipment:
                            - Dumbbells
                          difficulty: Intermediate
                          visibility: Company
                          imageUrl: https://cdn.example.com/exercises/rdl.jpg
                          lastUsedAt: null
                          context:
                            planId: 67f1234567890abcdef1234
                            planMomentId: 67f1234567890abcdef1234
                            workoutExerciseId: 67f1234567890abcdef1234
                      count: 10
                    meta:
                      requestId: 4f849d7d-f4f1-45cc-b4b7-3984a3d17f83
                      rateLimit:
                        limit: 10
                        remaining: 9
                        resetSeconds: 1
        '400':
          description: Authenticated user 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/exercises/last-used" \
              -H "Authorization: Bearer <access_token>"
components:
  schemas:
    PublicApiSuccessResponse:
      type: object
      additionalProperties: false
      required:
        - data
        - meta
      properties:
        data:
          type: object
        meta:
          $ref: '#/components/schemas/PublicApiMeta'
    PublicWorkoutSourceGETAppV1WorkoutExercisesLastUsedResponse200:
      type: object
      properties:
        items:
          type: array
          items:
            type: object
            properties:
              exerciseId:
                type: string
                example: 67f1234567890abcdef1234
              name:
                type: string
                example: Romanian Deadlift
              primaryCategory:
                type: string
                enum:
                  - Agility & Speed
                  - Strength
                  - Hypertrophy
                  - Strength - Dynamic
                  - Strength - Explosive
                  - Strength - Static
                  - Cardio
                  - Cardio - Duration
                  - Cardio - Interval
                  - HIIT
                  - Crossfit
                  - Mobility
                  - Stretching
                  - Core
                  - Coordination & Balance
                  - Movement Prep
                  - Functional Training
                  - Recovery
                  - Sports
                  - Martial Arts
                  - Yoga
                  - Other
                  - GROUP_WORKOUT_TEMPLATE
                  - Plyometric
                  - Cycling
                  - Cardio - interval
                  - Mobilisation
                  - Stabilisation
                  - Daily Living
                  - Target zone
                  - Respiration
                  - Breathing
                  - Massage
                  - Outdoor sports
                  - Indoor sports
                  - Dance
                  - Group Lessons
                  - Martial arts
                  - Material Arts
                  - Fight skills
                  - Mind and body
                  - ''
                  - default
                example: Strength
              secondaryCategories:
                type: array
                items:
                  type: string
                  enum:
                    - Agility & Speed
                    - Strength
                    - Hypertrophy
                    - Strength - Dynamic
                    - Strength - Explosive
                    - Strength - Static
                    - Cardio
                    - Cardio - Duration
                    - Cardio - Interval
                    - HIIT
                    - Crossfit
                    - Mobility
                    - Stretching
                    - Core
                    - Coordination & Balance
                    - Movement Prep
                    - Functional Training
                    - Recovery
                    - Sports
                    - Martial Arts
                    - Yoga
                    - Other
                    - GROUP_WORKOUT_TEMPLATE
                    - Plyometric
                    - Cycling
                    - Cardio - interval
                    - Mobilisation
                    - Stabilisation
                    - Daily Living
                    - Target zone
                    - Respiration
                    - Breathing
                    - Massage
                    - Outdoor sports
                    - Indoor sports
                    - Dance
                    - Group Lessons
                    - Martial arts
                    - Material Arts
                    - Fight skills
                    - Mind and body
                    - ''
                    - default
              primaryMuscle:
                type:
                  - string
                  - 'null'
                example: Hamstrings
              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
              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
                  - 'null'
                example: Intermediate
              visibility:
                type: string
                enum:
                  - Everyone
                  - Company
                  - Fitsociety
                example: Company
              imageUrl:
                type: string
                example: https://cdn.example.com/exercises/rdl.jpg
              lastUsedAt:
                type:
                  - string
                  - 'null'
                format: date-time
                example: null
              context:
                type: object
                properties:
                  planId:
                    type: string
                    example: 67f1234567890abcdef1234
                  planMomentId:
                    type: string
                    example: 67f1234567890abcdef1234
                  workoutExerciseId:
                    type: string
                    example: 67f1234567890abcdef1234
        count:
          type: number
          example: 10
    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.