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

# Client training page — assigned plans + all dashboard sections

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

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



## OpenAPI

````yaml /openapi/public-v1.json get /public/v1/workout/plans/assigned-by-coach
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/plans/assigned-by-coach:
    get:
      tags:
        - Workout
      summary: Client training page — assigned plans + all dashboard sections
      description: >-
        Read collections default to 10 records. limit accepts 1 through 100;
        larger values use 100. Continue with page using the returned pagination
        metadata. Owned collections have no page ceiling.


        Requires the `workout_plans:read` scope and the corresponding Workout
        features and permissions.
      operationId: publicWorkoutgetPublicV1WorkoutPlansAssignedByCoach
      parameters:
        - in: query
          name: clientId
          schema:
            type: string
            example: 67f1234567890abcdef1234
          required: false
          description: >-
            Client id. Required when the caller is a coach; inferred from token
            when the caller is a client.
        - name: page
          in: query
          schema:
            type: integer
            minimum: 1
            default: 1
        - name: limit
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 10
        - in: query
          name: search
          schema:
            type: string
          description: Case-insensitive search on plan name.
        - in: query
          name: levels
          schema:
            type: string
          description: >-
            Comma-separated difficulty filter: `Beginner`, `Intermediate`,
            `Advanced`.
          example: Beginner,Intermediate
        - in: query
          name: status
          schema:
            type: string
          description: 'Comma-separated status filter: `Active`, `Inactive`, `Completed`.'
          example: Active
        - in: query
          name: planType
          schema:
            type: array
            items:
              type: string
              enum:
                - recurring
                - multi_week
          style: form
          explode: false
          description: >-
            Comma-separated programme-kind filter on `schedule.mode`:
            `recurring` / `multi_week`. A plan with no stored mode counts as
            `recurring`. Applies to both `plans` and `coach-led` rows (a
            coach-led row uses its template's mode). Both or neither → no
            filter. Unknown values are ignored. `cards` are not affected.
          example: multi_week
        - in: query
          name: selectedWeekStart
          required: false
          description: >-
            Canonical company-local Monday for the requested programme week or
            recurring cycle. Omit to use the current company-local week.
          schema:
            type: string
            format: date
            pattern: ^\d{4}-\d{2}-\d{2}$
            example: '2026-09-14'
      responses:
        '200':
          description: Successful Workout response.
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/PublicApiSuccessResponse'
                  - type: object
                    properties:
                      data:
                        $ref: >-
                          #/components/schemas/PublicWorkoutSourceGETAppV1WorkoutPlansAssignedByCoachResponse200
              examples:
                success:
                  summary: Successful response
                  value:
                    data:
                      cards:
                        totalPlans: 14
                        activeNow: 8
                        completed: 6
                        currentProgress: 56
                      plans:
                        - isWodPlan: false
                          _id: 67f1234567890abcdef1234
                          name: Beginner Swim Training Program
                          thumbnail: https://cdn.example.com/plan.jpg
                          difficulty: Beginner
                          intensity: Medium
                          category: Strength
                          status: Active
                          scheduleMode: recurring
                          createdBy:
                            _id: 67f1234567890abcdef1234
                            firstName: Jane
                            lastName: Smith
                            image: https://cdn.example.com/coaches/jane.jpg
                            role: Coach
                          duration:
                            startDate: '2026-03-26'
                            endDate: '2026-06-20'
                            hasEndDate: true
                          schedule:
                            mode: multi_week
                            releasePolicy: weekly_from_start
                            startDate: '2026-09-08'
                            timeZone: Europe/Amsterdam
                            totalWeeks: 4
                            layout: calendar_week
                            weeks:
                              - weekNumber: 1
                                days:
                                  - weekday: 1
                                    isRestDay: false
                                    items:
                                      - _id: 67f1234567890abcdef1234
                                        order: 1
                                        startTime: '08:30'
                                        plannedDurationMinutes: 45
                                        status: today
                                        plannedDate: '2026-09-08'
                                        scheduledDate: '2026-09-08'
                                        source: programme
                                        clientAdjustment:
                                          action: moved
                                          occurrenceDate: '2026-09-08'
                                          scheduledDate: '2026-09-08'
                                          changedAt: null
                                        canClientRestore: true
                                        type: workout
                                        planMomentId: 67f1234567890abcdef1234
                          weeks:
                            - weekNumber: 2
                              availableFrom: '2026-09-08'
                              isAvailable: false
                              progressPercentage: 50
                              isCompleted: false
                              days:
                                - weekday: 1
                                  date: '2026-09-08'
                                  isBeforeStart: false
                                  isRestDay: false
                                  items:
                                    - _id: 67f1234567890abcdef1234
                                      order: 1
                                      startTime: '08:30'
                                      plannedDurationMinutes: 45
                                      status: today
                                      plannedDate: '2026-09-08'
                                      scheduledDate: '2026-09-08'
                                      source: programme
                                      clientAdjustment:
                                        action: moved
                                        occurrenceDate: '2026-09-08'
                                        scheduledDate: '2026-09-08'
                                        changedAt: null
                                      canClientRestore: true
                                      type: workout
                                      planMomentId: 67f1234567890abcdef1234
                          requiresProgrammeCalendarFeature: true
                          createdAt: '2026-04-12T10:00:00.000Z'
                      availableFilters:
                        levels:
                          - Beginner
                          - Intermediate
                          - Advanced
                        status:
                          - Active
                          - Inactive
                          - Completed
                        planType:
                          - recurring
                          - multi_week
                      selectedFilters:
                        search: ''
                        levels: []
                        status: []
                        planType: []
                      pagination:
                        page: 1
                        limit: 10
                        totalItems: 14
                        totalPages: 2
                        totalAvailableItems: 1
                      performanceSummary:
                        sessionsTotal: 81
                        sessionsCompleted: 56
                        averageRating: 7.8
                        maxWeight: 109
                        averageVolumePerSession: 3895.1
                        distinctExercises: 59
                        totalReps: 1128
                        totalTimeSeconds: 331200
                        totalVolume: 218130.5
                        totalActiveWorkout: 3
                      muscleActivation:
                        range:
                          startDate: '2026-07-14T10:00:00.000Z'
                          endDate: '2026-07-14T10:00:00.000Z'
                          days: 7
                        total:
                          raw: {}
                          normalized: {}
                          maxValue: 420
                          topMuscles:
                            - muscle: Quadriceps
                              value: 420
                      freestyleWorkout:
                        state: continue
                        sessionId: 67f1234567890abcdef1234
                        planId: 67f1234567890abcdef1234
                        planMomentId: 67f1234567890abcdef1234
                        status: in_progress
                        startedAt: '2026-04-12T10:00:00.000Z'
                      trainingSectionsAccess:
                        pageEnabled: true
                        trainingPlanAssignedSection: true
                        freestyleWorkout: true
                        videoLibrary: true
                        performanceSummary: true
                        muscleActivation: true
                        dailyTrainingNotes: true
                        workoutPlanLibrary: true
                    meta:
                      requestId: 4f849d7d-f4f1-45cc-b4b7-3984a3d17f83
                      rateLimit:
                        limit: 10
                        remaining: 9
                        resetSeconds: 1
        '400':
          description: >-
            Company context missing (`COMPANY_ID_REQUIRED`), invalid or missing
            client id (`INVALID_CLIENT_ID`), invalid pagination, or invalid
            selected recurring-week Monday.
          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_plans:read
                    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/plans/assigned-by-coach"
            \
              -H "Authorization: Bearer <access_token>"
components:
  schemas:
    PublicApiSuccessResponse:
      type: object
      additionalProperties: false
      required:
        - data
        - meta
      properties:
        data:
          type: object
        meta:
          $ref: '#/components/schemas/PublicApiMeta'
    PublicWorkoutSourceGETAppV1WorkoutPlansAssignedByCoachResponse200:
      type: object
      properties:
        cards:
          type: object
          properties:
            totalPlans:
              type: integer
              example: 14
            activeNow:
              type: integer
              example: 8
            completed:
              type: integer
              example: 6
            currentProgress:
              type: integer
              example: 56
              description: >-
                Percentage of completed active programme moments across assigned
                plans; recurring sequence days remain reusable and do not count
                historical completions. Archived/deleted moments are excluded.
        plans:
          type: array
          items:
            type: object
            properties:
              isWodPlan:
                type: boolean
                example: false
                description: >-
                  Whether this row represents a WOD plan; client visibility
                  actions do not apply to WOD plans.
              _id:
                type: string
                example: 67f1234567890abcdef1234
              name:
                type: string
                example: Beginner Swim Training Program
              thumbnail:
                type: string
                example: https://cdn.example.com/plan.jpg
              difficulty:
                type: string
                example: Beginner
              intensity:
                type: string
                example: Medium
              category:
                type: string
                example: Strength
              status:
                type: string
                enum:
                  - Active
                  - Inactive
                  - Completed
                example: Active
                description: >-
                  Stored Inactive plans remain Inactive. Active recurring
                  sequence plans remain Active. Multi-week/calendar programme
                  status is derived all-time from exact plan/moment completed
                  sessions across active moments, after honoring stored
                  inactivity.
              scheduleMode:
                type: string
                enum:
                  - recurring
                  - multi_week
                example: recurring
                description: >-
                  Programme kind from `schedule.mode` (`recurring` when the plan
                  never stored one) — the value the `planType` filter matches.
                  For a `coach-led` row it is the template's mode.
              createdBy:
                type: object
                nullable: true
                properties:
                  _id:
                    type: string
                    example: 67f1234567890abcdef1234
                  firstName:
                    type: string
                    example: Jane
                  lastName:
                    type: string
                    example: Smith
                  image:
                    type: string
                    example: https://cdn.example.com/coaches/jane.jpg
                  role:
                    type: string
                    enum:
                      - Coach
                      - Client
                    example: Coach
              duration:
                type: object
                properties:
                  startDate:
                    type: string
                    example: '2026-03-26'
                  endDate:
                    type: string
                    example: '2026-06-20'
                  hasEndDate:
                    type: boolean
                    example: true
              schedule:
                type: object
                required:
                  - mode
                  - releasePolicy
                  - startDate
                  - timeZone
                  - totalWeeks
                properties:
                  mode:
                    type: string
                    enum:
                      - recurring
                      - multi_week
                    example: multi_week
                  releasePolicy:
                    type: string
                    enum:
                      - all_at_once
                      - weekly_from_start
                    example: weekly_from_start
                  startDate:
                    oneOf:
                      - type: string
                        format: date
                        pattern: ^\d{4}-\d{2}-\d{2}$
                        example: '2026-09-08'
                      - type: string
                        enum:
                          - ''
                        example: ''
                    description: >-
                      Blank for templates and legacy sequence recurring
                      schedules. Assigned recurring calendar_week schedules
                      require the canonical company-local Monday anchor.
                      Assigned multi-week schedules accept any canonical date;
                      for calendar_week, week 1 is the Monday-Sunday week
                      containing it and days before it are not scheduled
                      (`isBeforeStart`).
                  timeZone:
                    type: string
                    example: Europe/Amsterdam
                    description: Company time zone used to evaluate weekly availability.
                  totalWeeks:
                    type: integer
                    minimum: 0
                    example: 4
                  layout:
                    type: string
                    enum:
                      - sequence
                      - calendar_week
                    example: calendar_week
                  weeks:
                    type: array
                    items:
                      type: object
                      required:
                        - weekNumber
                        - days
                      properties:
                        weekNumber:
                          type: integer
                          minimum: 1
                          example: 1
                        days:
                          type: array
                          items:
                            type: object
                            required:
                              - weekday
                              - isRestDay
                              - items
                            properties:
                              weekday:
                                type: integer
                                minimum: 1
                                maximum: 7
                                example: 1
                                description: >-
                                  ISO weekday number: 1 is Monday and 7 is
                                  Sunday.
                              isRestDay:
                                type: boolean
                                example: false
                              items:
                                type: array
                                items:
                                  oneOf:
                                    - type: object
                                      additionalProperties: false
                                      required:
                                        - type
                                        - order
                                        - planMomentId
                                      properties:
                                        _id:
                                          type: string
                                          example: 67f1234567890abcdef1234
                                        order:
                                          type: integer
                                          minimum: 1
                                          example: 1
                                        startTime:
                                          type: string
                                          pattern: ^(?:[01]\d|2[0-3]):[0-5]\d$|^$
                                          example: '08:30'
                                        plannedDurationMinutes:
                                          type:
                                            - number
                                            - 'null'
                                          minimum: 0
                                          example: 45
                                          description: >-
                                            Planned duration in minutes; null when
                                            no target is set.
                                        status:
                                          type:
                                            - string
                                            - 'null'
                                          enum:
                                            - in_progress
                                            - completed
                                            - overdue
                                            - today
                                            - upcoming
                                            - null
                                          readOnly: true
                                          example: today
                                          description: >-
                                            Occurrence presentation status. Template
                                            items use null; cancelled occurrences
                                            fall back to overdue, today, or
                                            upcoming.
                                        plannedDate:
                                          oneOf:
                                            - type: string
                                              format: date
                                              pattern: ^\d{4}-\d{2}-\d{2}$
                                              example: '2026-09-08'
                                            - type: string
                                              enum:
                                                - ''
                                              example: ''
                                          readOnly: true
                                          description: >-
                                            Original authored occurrence date for a
                                            calendar response item.
                                        scheduledDate:
                                          oneOf:
                                            - type: string
                                              format: date
                                              pattern: ^\d{4}-\d{2}-\d{2}$
                                              example: '2026-09-08'
                                            - type: string
                                              enum:
                                                - ''
                                              example: ''
                                          readOnly: true
                                          description: >-
                                            Effective calendar date after a client
                                            move; otherwise plannedDate.
                                        source:
                                          type: string
                                          enum:
                                            - programme
                                          readOnly: true
                                        clientAdjustment:
                                          oneOf:
                                            - type: object
                                              required:
                                                - action
                                                - occurrenceDate
                                                - scheduledDate
                                                - changedAt
                                              properties:
                                                action:
                                                  type: string
                                                  enum:
                                                    - moved
                                                    - skipped
                                                occurrenceDate:
                                                  type: string
                                                  format: date
                                                  pattern: ^\d{4}-\d{2}-\d{2}$
                                                  example: '2026-09-08'
                                                scheduledDate:
                                                  oneOf:
                                                    - type: string
                                                      format: date
                                                      pattern: ^\d{4}-\d{2}-\d{2}$
                                                      example: '2026-09-08'
                                                    - type: string
                                                      enum:
                                                        - ''
                                                      example: ''
                                                changedAt:
                                                  type:
                                                    - string
                                                    - 'null'
                                                  format: date-time
                                                  example: null
                                            - type: 'null'
                                          readOnly: true
                                        canClientRestore:
                                          type: boolean
                                          readOnly: true
                                        type:
                                          type: string
                                          enum:
                                            - workout
                                          example: workout
                                        planMomentId:
                                          type: string
                                          example: 67f1234567890abcdef1234
                                    - type: object
                                      additionalProperties: false
                                      required:
                                        - type
                                        - order
                                        - activityType
                                        - name
                                      properties:
                                        _id:
                                          type: string
                                          example: 67f1234567890abcdef1234
                                        order:
                                          type: integer
                                          minimum: 1
                                          example: 1
                                        startTime:
                                          type: string
                                          pattern: ^(?:[01]\d|2[0-3]):[0-5]\d$|^$
                                          example: '08:30'
                                        plannedDurationMinutes:
                                          type:
                                            - number
                                            - 'null'
                                          minimum: 0
                                          example: 45
                                          description: >-
                                            Planned duration in minutes; null when
                                            no target is set.
                                        status:
                                          type:
                                            - string
                                            - 'null'
                                          enum:
                                            - in_progress
                                            - completed
                                            - overdue
                                            - today
                                            - upcoming
                                            - null
                                          readOnly: true
                                          example: today
                                          description: >-
                                            Occurrence presentation status. Template
                                            items use null; cancelled occurrences
                                            fall back to overdue, today, or
                                            upcoming.
                                        plannedDate:
                                          oneOf:
                                            - type: string
                                              format: date
                                              pattern: ^\d{4}-\d{2}-\d{2}$
                                              example: '2026-09-08'
                                            - type: string
                                              enum:
                                                - ''
                                              example: ''
                                          readOnly: true
                                          description: >-
                                            Original authored occurrence date for a
                                            calendar response item.
                                        scheduledDate:
                                          oneOf:
                                            - type: string
                                              format: date
                                              pattern: ^\d{4}-\d{2}-\d{2}$
                                              example: '2026-09-08'
                                            - type: string
                                              enum:
                                                - ''
                                              example: ''
                                          readOnly: true
                                          description: >-
                                            Effective calendar date after a client
                                            move; otherwise plannedDate.
                                        source:
                                          type: string
                                          enum:
                                            - programme
                                          readOnly: true
                                        clientAdjustment:
                                          oneOf:
                                            - type: object
                                              required:
                                                - action
                                                - occurrenceDate
                                                - scheduledDate
                                                - changedAt
                                              properties:
                                                action:
                                                  type: string
                                                  enum:
                                                    - moved
                                                    - skipped
                                                occurrenceDate:
                                                  type: string
                                                  format: date
                                                  pattern: ^\d{4}-\d{2}-\d{2}$
                                                  example: '2026-09-08'
                                                scheduledDate:
                                                  oneOf:
                                                    - type: string
                                                      format: date
                                                      pattern: ^\d{4}-\d{2}-\d{2}$
                                                      example: '2026-09-08'
                                                    - type: string
                                                      enum:
                                                        - ''
                                                      example: ''
                                                changedAt:
                                                  type:
                                                    - string
                                                    - 'null'
                                                  format: date-time
                                                  example: null
                                            - type: 'null'
                                          readOnly: true
                                        canClientRestore:
                                          type: boolean
                                          readOnly: true
                                        type:
                                          type: string
                                          enum:
                                            - activity
                                          example: activity
                                        activityType:
                                          type: string
                                          enum:
                                            - running
                                            - cycling
                                            - walking
                                            - swimming
                                            - rowing
                                            - padel
                                            - mobility
                                            - other
                                          example: running
                                        name:
                                          type: array
                                          minItems: 1
                                          items:
                                            type: object
                                            required:
                                              - lang
                                              - value
                                            properties:
                                              lang:
                                                type: string
                                                enum:
                                                  - en
                                                  - nl
                                                  - fr
                                                  - de
                                                  - es
                                                example: en
                                              value:
                                                type: string
                                                example: Full Body Strength
                                          example:
                                            - lang: en
                                              value: Full Body Strength
                                            - lang: nl
                                              value: Full Body Kracht
                                        description:
                                          type: array
                                          items:
                                            type: object
                                            required:
                                              - lang
                                              - value
                                            properties:
                                              lang:
                                                type: string
                                                enum:
                                                  - en
                                                  - nl
                                                  - fr
                                                  - de
                                                  - es
                                                example: en
                                              value:
                                                type: string
                                                example: Full Body Strength
                                        cardio:
                                          anyOf:
                                            - type: object
                                              additionalProperties: false
                                              description: >-
                                                Optional structured activity
                                                prescription. Requires Workout + Workout
                                                programme calendar + Workout cardio
                                                builder. Omitted from disabled reads.
                                                Supported sports: running (paceZone
                                                E/T/I/R/RP, absolute pace, absolute HR,
                                                RPE), walking (pace, HR, RPE), cycling
                                                (power, HR, RPE), rowing (pace, power,
                                                HR, RPE), swimming (pace, RPE). Rejected
                                                for workout, padel, mobility and other
                                                items. Totals overwrite planned
                                                duration/distance; unknown time or
                                                distance contributes zero.
                                              properties:
                                                slotKey:
                                                  type: string
                                                  description: >-
                                                    Generated when missing; retain across
                                                    edits, copies and weeks.
                                                sessionType:
                                                  type: string
                                                  enum:
                                                    - easy
                                                    - zone2
                                                    - long_run
                                                    - threshold_continuous
                                                    - threshold_reps
                                                    - interval
                                                    - race_pace
                                                    - time_trial
                                                    - race
                                                  description: >-
                                                    Running only. Template session codes:
                                                    threshold_continuous = drempel_c,
                                                    threshold_reps = drempel_r, interval,
                                                    race_pace = doeltempo, zone2. A typed
                                                    session with empty blocks is a skeleton
                                                    to be filled later.
                                                controlMode:
                                                  type: string
                                                  enum:
                                                    - pace
                                                    - hr
                                                  description: >-
                                                    Binding signal. Defaults from
                                                    sessionType: hr for easy, zone2 and
                                                    long_run; pace for threshold_continuous,
                                                    threshold_reps, interval and race_pace;
                                                    none for time_trial and race. A
                                                    contradicting value is rejected.
                                                ladderStep:
                                                  type: integer
                                                  minimum: 1
                                                  description: >-
                                                    Ladder position: interval 1–8,
                                                    threshold_reps 1–7, threshold_continuous
                                                    1–5 (15/18/20/22/25 min). Rejected for
                                                    other session types.
                                                poolLengthM:
                                                  type: number
                                                  enum:
                                                    - 25
                                                    - 50
                                                  description: Swimming only.
                                                blocks:
                                                  type: array
                                                  maxItems: 10
                                                  items:
                                                    type: object
                                                    additionalProperties: false
                                                    properties:
                                                      _id:
                                                        type: string
                                                        example: 67f1234567890abcdef1234
                                                      repeat:
                                                        type: integer
                                                        minimum: 1
                                                        maximum: 50
                                                        default: 1
                                                      steps:
                                                        type: array
                                                        maxItems: 20
                                                        items:
                                                          type: object
                                                          additionalProperties: false
                                                          required:
                                                            - kind
                                                            - durationType
                                                          properties:
                                                            _id:
                                                              type: string
                                                              example: 67f1234567890abcdef1234
                                                            kind:
                                                              type: string
                                                              enum:
                                                                - warmup
                                                                - work
                                                                - recovery
                                                                - rest
                                                                - cooldown
                                                            durationType:
                                                              type: string
                                                              enum:
                                                                - time
                                                                - distance
                                                                - open
                                                            durationValue:
                                                              type:
                                                                - number
                                                                - 'null'
                                                              minimum: 0
                                                              default: null
                                                              description: >-
                                                                Required seconds for time or metres for
                                                                distance; null/omitted for open.
                                                            target:
                                                              type: object
                                                              additionalProperties: false
                                                              required:
                                                                - kind
                                                              description: >-
                                                                Allowed kinds and zones depend on the
                                                                sport. Zone targets require zone; other
                                                                targets require ordered low/high bounds.
                                                                Pace is seconds/km for running/walking,
                                                                seconds/500m for rowing, seconds/100m
                                                                for swimming. Percentages are percent
                                                                values; HR is bpm, power is watts, RPE
                                                                is 1–10. Numeric strings with dot or
                                                                comma decimals are accepted.
                                                              properties:
                                                                kind:
                                                                  type: string
                                                                  enum:
                                                                    - paceZone
                                                                    - pacePct
                                                                    - pace
                                                                    - hrZone
                                                                    - hrPct
                                                                    - hr
                                                                    - powerZone
                                                                    - powerPct
                                                                    - power
                                                                    - rpe
                                                                zone:
                                                                  type: string
                                                                  enum:
                                                                    - E
                                                                    - T
                                                                    - I
                                                                    - R
                                                                    - RP
                                                                    - Z1
                                                                    - Z2
                                                                    - Z3
                                                                    - Z4
                                                                    - Z5
                                                                    - Z6
                                                                    - Z7
                                                                    - easy
                                                                    - endurance
                                                                    - threshold
                                                                    - speed
                                                                  description: >-
                                                                    Run pace: E (easy), T (threshold), I
                                                                    (interval), R (repetition), RP (race
                                                                    pace = goal time / goal distance, never
                                                                    derived from T). Running has no HR
                                                                    zones; HR bands are absolute bpm from
                                                                    athlete data. Walking/rowing pace and
                                                                    five-zone HR: Z1–Z5. Bike/row power:
                                                                    Z1–Z7. Swimming pace: easy, endurance,
                                                                    threshold, speed.
                                                                basis:
                                                                  type: string
                                                                  enum:
                                                                    - lthr
                                                                    - maxHr
                                                                  description: HR zone/percentage targets only.
                                                                low:
                                                                  type: number
                                                                  minimum: 0
                                                                high:
                                                                  type: number
                                                                  minimum: 0
                                                            secondaryTarget:
                                                              type: object
                                                              additionalProperties: false
                                                              required:
                                                                - kind
                                                              description: >-
                                                                Allowed kinds and zones depend on the
                                                                sport. Zone targets require zone; other
                                                                targets require ordered low/high bounds.
                                                                Pace is seconds/km for running/walking,
                                                                seconds/500m for rowing, seconds/100m
                                                                for swimming. Percentages are percent
                                                                values; HR is bpm, power is watts, RPE
                                                                is 1–10. Numeric strings with dot or
                                                                comma decimals are accepted.
                                                              properties:
                                                                kind:
                                                                  type: string
                                                                  enum:
                                                                    - paceZone
                                                                    - pacePct
                                                                    - pace
                                                                    - hrZone
                                                                    - hrPct
                                                                    - hr
                                                                    - powerZone
                                                                    - powerPct
                                                                    - power
                                                                    - rpe
                                                                zone:
                                                                  type: string
                                                                  enum:
                                                                    - E
                                                                    - T
                                                                    - I
                                                                    - R
                                                                    - RP
                                                                    - Z1
                                                                    - Z2
                                                                    - Z3
                                                                    - Z4
                                                                    - Z5
                                                                    - Z6
                                                                    - Z7
                                                                    - easy
                                                                    - endurance
                                                                    - threshold
                                                                    - speed
                                                                  description: >-
                                                                    Run pace: E (easy), T (threshold), I
                                                                    (interval), R (repetition), RP (race
                                                                    pace = goal time / goal distance, never
                                                                    derived from T). Running has no HR
                                                                    zones; HR bands are absolute bpm from
                                                                    athlete data. Walking/rowing pace and
                                                                    five-zone HR: Z1–Z5. Bike/row power:
                                                                    Z1–Z7. Swimming pace: easy, endurance,
                                                                    threshold, speed.
                                                                basis:
                                                                  type: string
                                                                  enum:
                                                                    - lthr
                                                                    - maxHr
                                                                  description: HR zone/percentage targets only.
                                                                low:
                                                                  type: number
                                                                  minimum: 0
                                                                high:
                                                                  type: number
                                                                  minimum: 0
                                                            notes:
                                                              type: string
                                                              default: ''
                                                            stroke:
                                                              type: string
                                                              enum:
                                                                - free
                                                                - back
                                                                - breast
                                                                - fly
                                                                - im
                                                                - choice
                                                                - kick
                                                                - drill
                                                              description: Swimming only.
                                                            equipment:
                                                              type: array
                                                              items:
                                                                type: string
                                                                enum:
                                                                  - pullBuoy
                                                                  - paddles
                                                                  - fins
                                                                  - kickboard
                                                                  - snorkel
                                                              description: Swimming only.
                                                            restMode:
                                                              type: string
                                                              enum:
                                                                - rest
                                                                - sendOff
                                                              description: >-
                                                                Swimming only. sendOff requires
                                                                sendOffSec.
                                                            sendOffSec:
                                                              type: number
                                                              minimum: 1
                                                              description: Swimming sendOff only.
                                                            cadence:
                                                              type: object
                                                              additionalProperties: false
                                                              required:
                                                                - low
                                                                - high
                                                              properties:
                                                                low:
                                                                  type: number
                                                                  minimum: 0
                                                                high:
                                                                  type: number
                                                                  minimum: 0
                                                        default: []
                                                  default: []
                                                sourceTemplateId:
                                                  type:
                                                    - string
                                                    - 'null'
                                                  example: null
                                            - type: 'null'
                                          description: >-
                                            Omit on update to preserve the stored
                                            prescription; null removes it. Writing
                                            or removing cardio requires the cardio
                                            builder feature.
                                        targetDistanceMeters:
                                          type:
                                            - number
                                            - 'null'
                                          minimum: 0
                                          example: 5000
                                          description: >-
                                            Planned distance in meters; null when no
                                            target is set.
                                        videoLibraryId:
                                          anyOf:
                                            - type: string
                                              example: 67f1234567890abcdef1234
                                            - type: 'null'
                                          description: >-
                                            Optional published company video-library
                                            video shown with the activity (yoga,
                                            ballet or any guided session). Requires
                                            the cardio builder feature (otherwise
                                            403 WORKOUT_V2_CARDIO_BUILDER_DISABLED);
                                            omit to preserve the stored link, null
                                            removes it. Must belong to the plan's
                                            company; otherwise 400
                                            WORKOUTPLAN_ACTIVITY_VIDEO_INVALID.
                                            Omitted from responses while the feature
                                            is disabled.
                                  discriminator:
                                    propertyName: type
                                    mapping:
                                      workout: >-
                                        #/components/schemas/WorkoutProgrammeCalendarWorkoutItem
                                      activity: >-
                                        #/components/schemas/WorkoutProgrammeCalendarActivityItem
              weeks:
                type: array
                description: >-
                  Additive calendar-week projection; omitted for legacy sequence
                  plans.
                items:
                  allOf:
                    - type: object
                      required:
                        - weekNumber
                        - availableFrom
                        - isAvailable
                        - progressPercentage
                        - isCompleted
                      properties:
                        weekNumber:
                          type: integer
                          minimum: 1
                          example: 2
                        availableFrom:
                          oneOf:
                            - type: string
                              format: date
                              pattern: ^\d{4}-\d{2}-\d{2}$
                              example: '2026-09-08'
                            - type: string
                              enum:
                                - ''
                              example: ''
                          description: >-
                            Canonical company-local release date; blank for
                            recurring plans and templates.
                        isAvailable:
                          type: boolean
                          example: false
                        progressPercentage:
                          type: integer
                          minimum: 0
                          maximum: 100
                          example: 50
                          description: >-
                            Percentage of active moments in this programme week
                            with a completed session. Ordinary recurring
                            sequence days remain reusable and do not retain
                            historical completion in progress.
                        isCompleted:
                          type: boolean
                          example: false
                    - type: object
                      required:
                        - days
                      properties:
                        days:
                          type: array
                          minItems: 7
                          maxItems: 7
                          description: All seven ISO weekdays in Monday-to-Sunday order.
                          items:
                            type: object
                            required:
                              - weekday
                              - date
                              - isRestDay
                              - items
                            properties:
                              weekday:
                                type: integer
                                minimum: 1
                                maximum: 7
                                example: 1
                                description: >-
                                  ISO weekday number: 1 is Monday and 7 is
                                  Sunday.
                              date:
                                oneOf:
                                  - type: string
                                    format: date
                                    pattern: ^\d{4}-\d{2}-\d{2}$
                                    example: '2026-09-08'
                                  - type: string
                                    enum:
                                      - ''
                                    example: ''
                                readOnly: true
                                description: >-
                                  Canonical company-local occurrence date.
                                  Template calendar days use an empty string.
                              isBeforeStart:
                                type: boolean
                                readOnly: true
                                example: false
                                description: >-
                                  True for week-1 days before a mid-week
                                  multi-week schedule.startDate. Such days are
                                  returned as rest days (isRestDay true, items
                                  empty); computed per response, never stored.
                                  Starting one of their occurrences is rejected.
                                  Always false for templates.
                              isRestDay:
                                type: boolean
                                example: false
                              items:
                                type: array
                                items:
                                  oneOf:
                                    - type: object
                                      additionalProperties: false
                                      required:
                                        - type
                                        - order
                                        - planMomentId
                                      properties:
                                        _id:
                                          type: string
                                          example: 67f1234567890abcdef1234
                                        order:
                                          type: integer
                                          minimum: 1
                                          example: 1
                                        startTime:
                                          type: string
                                          pattern: ^(?:[01]\d|2[0-3]):[0-5]\d$|^$
                                          example: '08:30'
                                        plannedDurationMinutes:
                                          type:
                                            - number
                                            - 'null'
                                          minimum: 0
                                          example: 45
                                          description: >-
                                            Planned duration in minutes; null when
                                            no target is set.
                                        status:
                                          type:
                                            - string
                                            - 'null'
                                          enum:
                                            - in_progress
                                            - completed
                                            - overdue
                                            - today
                                            - upcoming
                                            - null
                                          readOnly: true
                                          example: today
                                          description: >-
                                            Occurrence presentation status. Template
                                            items use null; cancelled occurrences
                                            fall back to overdue, today, or
                                            upcoming.
                                        plannedDate:
                                          oneOf:
                                            - type: string
                                              format: date
                                              pattern: ^\d{4}-\d{2}-\d{2}$
                                              example: '2026-09-08'
                                            - type: string
                                              enum:
                                                - ''
                                              example: ''
                                          readOnly: true
                                          description: >-
                                            Original authored occurrence date for a
                                            calendar response item.
                                        scheduledDate:
                                          oneOf:
                                            - type: string
                                              format: date
                                              pattern: ^\d{4}-\d{2}-\d{2}$
                                              example: '2026-09-08'
                                            - type: string
                                              enum:
                                                - ''
                                              example: ''
                                          readOnly: true
                                          description: >-
                                            Effective calendar date after a client
                                            move; otherwise plannedDate.
                                        source:
                                          type: string
                                          enum:
                                            - programme
                                          readOnly: true
                                        clientAdjustment:
                                          oneOf:
                                            - type: object
                                              required:
                                                - action
                                                - occurrenceDate
                                                - scheduledDate
                                                - changedAt
                                              properties:
                                                action:
                                                  type: string
                                                  enum:
                                                    - moved
                                                    - skipped
                                                occurrenceDate:
                                                  type: string
                                                  format: date
                                                  pattern: ^\d{4}-\d{2}-\d{2}$
                                                  example: '2026-09-08'
                                                scheduledDate:
                                                  oneOf:
                                                    - type: string
                                                      format: date
                                                      pattern: ^\d{4}-\d{2}-\d{2}$
                                                      example: '2026-09-08'
                                                    - type: string
                                                      enum:
                                                        - ''
                                                      example: ''
                                                changedAt:
                                                  type:
                                                    - string
                                                    - 'null'
                                                  format: date-time
                                                  example: null
                                            - type: 'null'
                                          readOnly: true
                                        canClientRestore:
                                          type: boolean
                                          readOnly: true
                                        type:
                                          type: string
                                          enum:
                                            - workout
                                          example: workout
                                        planMomentId:
                                          type: string
                                          example: 67f1234567890abcdef1234
                                    - type: object
                                      additionalProperties: false
                                      required:
                                        - type
                                        - order
                                        - activityType
                                        - name
                                      properties:
                                        _id:
                                          type: string
                                          example: 67f1234567890abcdef1234
                                        order:
                                          type: integer
                                          minimum: 1
                                          example: 1
                                        startTime:
                                          type: string
                                          pattern: ^(?:[01]\d|2[0-3]):[0-5]\d$|^$
                                          example: '08:30'
                                        plannedDurationMinutes:
                                          type:
                                            - number
                                            - 'null'
                                          minimum: 0
                                          example: 45
                                          description: >-
                                            Planned duration in minutes; null when
                                            no target is set.
                                        status:
                                          type:
                                            - string
                                            - 'null'
                                          enum:
                                            - in_progress
                                            - completed
                                            - overdue
                                            - today
                                            - upcoming
                                            - null
                                          readOnly: true
                                          example: today
                                          description: >-
                                            Occurrence presentation status. Template
                                            items use null; cancelled occurrences
                                            fall back to overdue, today, or
                                            upcoming.
                                        plannedDate:
                                          oneOf:
                                            - type: string
                                              format: date
                                              pattern: ^\d{4}-\d{2}-\d{2}$
                                              example: '2026-09-08'
                                            - type: string
                                              enum:
                                                - ''
                                              example: ''
                                          readOnly: true
                                          description: >-
                                            Original authored occurrence date for a
                                            calendar response item.
                                        scheduledDate:
                                          oneOf:
                                            - type: string
                                              format: date
                                              pattern: ^\d{4}-\d{2}-\d{2}$
                                              example: '2026-09-08'
                                            - type: string
                                              enum:
                                                - ''
                                              example: ''
                                          readOnly: true
                                          description: >-
                                            Effective calendar date after a client
                                            move; otherwise plannedDate.
                                        source:
                                          type: string
                                          enum:
                                            - programme
                                          readOnly: true
                                        clientAdjustment:
                                          oneOf:
                                            - type: object
                                              required:
                                                - action
                                                - occurrenceDate
                                                - scheduledDate
                                                - changedAt
                                              properties:
                                                action:
                                                  type: string
                                                  enum:
                                                    - moved
                                                    - skipped
                                                occurrenceDate:
                                                  type: string
                                                  format: date
                                                  pattern: ^\d{4}-\d{2}-\d{2}$
                                                  example: '2026-09-08'
                                                scheduledDate:
                                                  oneOf:
                                                    - type: string
                                                      format: date
                                                      pattern: ^\d{4}-\d{2}-\d{2}$
                                                      example: '2026-09-08'
                                                    - type: string
                                                      enum:
                                                        - ''
                                                      example: ''
                                                changedAt:
                                                  type:
                                                    - string
                                                    - 'null'
                                                  format: date-time
                                                  example: null
                                            - type: 'null'
                                          readOnly: true
                                        canClientRestore:
                                          type: boolean
                                          readOnly: true
                                        type:
                                          type: string
                                          enum:
                                            - activity
                                          example: activity
                                        activityType:
                                          type: string
                                          enum:
                                            - running
                                            - cycling
                                            - walking
                                            - swimming
                                            - rowing
                                            - padel
                                            - mobility
                                            - other
                                          example: running
                                        name:
                                          type: array
                                          minItems: 1
                                          items:
                                            type: object
                                            required:
                                              - lang
                                              - value
                                            properties:
                                              lang:
                                                type: string
                                                enum:
                                                  - en
                                                  - nl
                                                  - fr
                                                  - de
                                                  - es
                                                example: en
                                              value:
                                                type: string
                                                example: Full Body Strength
                                          example:
                                            - lang: en
                                              value: Full Body Strength
                                            - lang: nl
                                              value: Full Body Kracht
                                        description:
                                          type: array
                                          items:
                                            type: object
                                            required:
                                              - lang
                                              - value
                                            properties:
                                              lang:
                                                type: string
                                                enum:
                                                  - en
                                                  - nl
                                                  - fr
                                                  - de
                                                  - es
                                                example: en
                                              value:
                                                type: string
                                                example: Full Body Strength
                                        cardio:
                                          anyOf:
                                            - type: object
                                              additionalProperties: false
                                              description: >-
                                                Optional structured activity
                                                prescription. Requires Workout + Workout
                                                programme calendar + Workout cardio
                                                builder. Omitted from disabled reads.
                                                Supported sports: running (paceZone
                                                E/T/I/R/RP, absolute pace, absolute HR,
                                                RPE), walking (pace, HR, RPE), cycling
                                                (power, HR, RPE), rowing (pace, power,
                                                HR, RPE), swimming (pace, RPE). Rejected
                                                for workout, padel, mobility and other
                                                items. Totals overwrite planned
                                                duration/distance; unknown time or
                                                distance contributes zero.
                                              properties:
                                                slotKey:
                                                  type: string
                                                  description: >-
                                                    Generated when missing; retain across
                                                    edits, copies and weeks.
                                                sessionType:
                                                  type: string
                                                  enum:
                                                    - easy
                                                    - zone2
                                                    - long_run
                                                    - threshold_continuous
                                                    - threshold_reps
                                                    - interval
                                                    - race_pace
                                                    - time_trial
                                                    - race
                                                  description: >-
                                                    Running only. Template session codes:
                                                    threshold_continuous = drempel_c,
                                                    threshold_reps = drempel_r, interval,
                                                    race_pace = doeltempo, zone2. A typed
                                                    session with empty blocks is a skeleton
                                                    to be filled later.
                                                controlMode:
                                                  type: string
                                                  enum:
                                                    - pace
                                                    - hr
                                                  description: >-
                                                    Binding signal. Defaults from
                                                    sessionType: hr for easy, zone2 and
                                                    long_run; pace for threshold_continuous,
                                                    threshold_reps, interval and race_pace;
                                                    none for time_trial and race. A
                                                    contradicting value is rejected.
                                                ladderStep:
                                                  type: integer
                                                  minimum: 1
                                                  description: >-
                                                    Ladder position: interval 1–8,
                                                    threshold_reps 1–7, threshold_continuous
                                                    1–5 (15/18/20/22/25 min). Rejected for
                                                    other session types.
                                                poolLengthM:
                                                  type: number
                                                  enum:
                                                    - 25
                                                    - 50
                                                  description: Swimming only.
                                                blocks:
                                                  type: array
                                                  maxItems: 10
                                                  items:
                                                    type: object
                                                    additionalProperties: false
                                                    properties:
                                                      _id:
                                                        type: string
                                                        example: 67f1234567890abcdef1234
                                                      repeat:
                                                        type: integer
                                                        minimum: 1
                                                        maximum: 50
                                                        default: 1
                                                      steps:
                                                        type: array
                                                        maxItems: 20
                                                        items:
                                                          type: object
                                                          additionalProperties: false
                                                          required:
                                                            - kind
                                                            - durationType
                                                          properties:
                                                            _id:
                                                              type: string
                                                              example: 67f1234567890abcdef1234
                                                            kind:
                                                              type: string
                                                              enum:
                                                                - warmup
                                                                - work
                                                                - recovery
                                                                - rest
                                                                - cooldown
                                                            durationType:
                                                              type: string
                                                              enum:
                                                                - time
                                                                - distance
                                                                - open
                                                            durationValue:
                                                              type:
                                                                - number
                                                                - 'null'
                                                              minimum: 0
                                                              default: null
                                                              description: >-
                                                                Required seconds for time or metres for
                                                                distance; null/omitted for open.
                                                            target:
                                                              type: object
                                                              additionalProperties: false
                                                              required:
                                                                - kind
                                                              description: >-
                                                                Allowed kinds and zones depend on the
                                                                sport. Zone targets require zone; other
                                                                targets require ordered low/high bounds.
                                                                Pace is seconds/km for running/walking,
                                                                seconds/500m for rowing, seconds/100m
                                                                for swimming. Percentages are percent
                                                                values; HR is bpm, power is watts, RPE
                                                                is 1–10. Numeric strings with dot or
                                                                comma decimals are accepted.
                                                              properties:
                                                                kind:
                                                                  type: string
                                                                  enum:
                                                                    - paceZone
                                                                    - pacePct
                                                                    - pace
                                                                    - hrZone
                                                                    - hrPct
                                                                    - hr
                                                                    - powerZone
                                                                    - powerPct
                                                                    - power
                                                                    - rpe
                                                                zone:
                                                                  type: string
                                                                  enum:
                                                                    - E
                                                                    - T
                                                                    - I
                                                                    - R
                                                                    - RP
                                                                    - Z1
                                                                    - Z2
                                                                    - Z3
                                                                    - Z4
                                                                    - Z5
                                                                    - Z6
                                                                    - Z7
                                                                    - easy
                                                                    - endurance
                                                                    - threshold
                                                                    - speed
                                                                  description: >-
                                                                    Run pace: E (easy), T (threshold), I
                                                                    (interval), R (repetition), RP (race
                                                                    pace = goal time / goal distance, never
                                                                    derived from T). Running has no HR
                                                                    zones; HR bands are absolute bpm from
                                                                    athlete data. Walking/rowing pace and
                                                                    five-zone HR: Z1–Z5. Bike/row power:
                                                                    Z1–Z7. Swimming pace: easy, endurance,
                                                                    threshold, speed.
                                                                basis:
                                                                  type: string
                                                                  enum:
                                                                    - lthr
                                                                    - maxHr
                                                                  description: HR zone/percentage targets only.
                                                                low:
                                                                  type: number
                                                                  minimum: 0
                                                                high:
                                                                  type: number
                                                                  minimum: 0
                                                            secondaryTarget:
                                                              type: object
                                                              additionalProperties: false
                                                              required:
                                                                - kind
                                                              description: >-
                                                                Allowed kinds and zones depend on the
                                                                sport. Zone targets require zone; other
                                                                targets require ordered low/high bounds.
                                                                Pace is seconds/km for running/walking,
                                                                seconds/500m for rowing, seconds/100m
                                                                for swimming. Percentages are percent
                                                                values; HR is bpm, power is watts, RPE
                                                                is 1–10. Numeric strings with dot or
                                                                comma decimals are accepted.
                                                              properties:
                                                                kind:
                                                                  type: string
                                                                  enum:
                                                                    - paceZone
                                                                    - pacePct
                                                                    - pace
                                                                    - hrZone
                                                                    - hrPct
                                                                    - hr
                                                                    - powerZone
                                                                    - powerPct
                                                                    - power
                                                                    - rpe
                                                                zone:
                                                                  type: string
                                                                  enum:
                                                                    - E
                                                                    - T
                                                                    - I
                                                                    - R
                                                                    - RP
                                                                    - Z1
                                                                    - Z2
                                                                    - Z3
                                                                    - Z4
                                                                    - Z5
                                                                    - Z6
                                                                    - Z7
                                                                    - easy
                                                                    - endurance
                                                                    - threshold
                                                                    - speed
                                                                  description: >-
                                                                    Run pace: E (easy), T (threshold), I
                                                                    (interval), R (repetition), RP (race
                                                                    pace = goal time / goal distance, never
                                                                    derived from T). Running has no HR
                                                                    zones; HR bands are absolute bpm from
                                                                    athlete data. Walking/rowing pace and
                                                                    five-zone HR: Z1–Z5. Bike/row power:
                                                                    Z1–Z7. Swimming pace: easy, endurance,
                                                                    threshold, speed.
                                                                basis:
                                                                  type: string
                                                                  enum:
                                                                    - lthr
                                                                    - maxHr
                                                                  description: HR zone/percentage targets only.
                                                                low:
                                                                  type: number
                                                                  minimum: 0
                                                                high:
                                                                  type: number
                                                                  minimum: 0
                                                            notes:
                                                              type: string
                                                              default: ''
                                                            stroke:
                                                              type: string
                                                              enum:
                                                                - free
                                                                - back
                                                                - breast
                                                                - fly
                                                                - im
                                                                - choice
                                                                - kick
                                                                - drill
                                                              description: Swimming only.
                                                            equipment:
                                                              type: array
                                                              items:
                                                                type: string
                                                                enum:
                                                                  - pullBuoy
                                                                  - paddles
                                                                  - fins
                                                                  - kickboard
                                                                  - snorkel
                                                              description: Swimming only.
                                                            restMode:
                                                              type: string
                                                              enum:
                                                                - rest
                                                                - sendOff
                                                              description: >-
                                                                Swimming only. sendOff requires
                                                                sendOffSec.
                                                            sendOffSec:
                                                              type: number
                                                              minimum: 1
                                                              description: Swimming sendOff only.
                                                            cadence:
                                                              type: object
                                                              additionalProperties: false
                                                              required:
                                                                - low
                                                                - high
                                                              properties:
                                                                low:
                                                                  type: number
                                                                  minimum: 0
                                                                high:
                                                                  type: number
                                                                  minimum: 0
                                                        default: []
                                                  default: []
                                                sourceTemplateId:
                                                  type:
                                                    - string
                                                    - 'null'
                                                  example: null
                                            - type: 'null'
                                          description: >-
                                            Omit on update to preserve the stored
                                            prescription; null removes it. Writing
                                            or removing cardio requires the cardio
                                            builder feature.
                                        targetDistanceMeters:
                                          type:
                                            - number
                                            - 'null'
                                          minimum: 0
                                          example: 5000
                                          description: >-
                                            Planned distance in meters; null when no
                                            target is set.
                                        videoLibraryId:
                                          anyOf:
                                            - type: string
                                              example: 67f1234567890abcdef1234
                                            - type: 'null'
                                          description: >-
                                            Optional published company video-library
                                            video shown with the activity (yoga,
                                            ballet or any guided session). Requires
                                            the cardio builder feature (otherwise
                                            403 WORKOUT_V2_CARDIO_BUILDER_DISABLED);
                                            omit to preserve the stored link, null
                                            removes it. Must belong to the plan's
                                            company; otherwise 400
                                            WORKOUTPLAN_ACTIVITY_VIDEO_INVALID.
                                            Omitted from responses while the feature
                                            is disabled.
                                  discriminator:
                                    propertyName: type
                                    mapping:
                                      workout: >-
                                        #/components/schemas/WorkoutProgrammeCalendarWorkoutItem
                                      activity: >-
                                        #/components/schemas/WorkoutProgrammeCalendarActivityItem
              requiresProgrammeCalendarFeature:
                type: boolean
                example: true
                description: >-
                  `true` for `calendar_week`, `multi_week`, or legacy later-week
                  content (`weekNumber > 1`); `false` for ordinary sequence
                  plans. Clients use this capability to gate programme-calendar
                  UI and actions.
              createdAt:
                type: string
                format: date-time
                example: '2026-04-12T10:00:00.000Z'
        availableFilters:
          type: object
          properties:
            levels:
              type: array
              items:
                type: string
              example:
                - Beginner
                - Intermediate
                - Advanced
            status:
              type: array
              items:
                type: string
              example:
                - Active
                - Inactive
                - Completed
            planType:
              type: array
              items:
                type: string
                enum:
                  - recurring
                  - multi_week
              example:
                - recurring
                - multi_week
        selectedFilters:
          type: object
          properties:
            search:
              type: string
              example: ''
            levels:
              type: array
              items:
                type: string
              example: []
            status:
              type: array
              items:
                type: string
              example: []
            planType:
              type: array
              items:
                type: string
                enum:
                  - recurring
                  - multi_week
              example: []
        pagination:
          type: object
          properties:
            page:
              type: integer
              example: 1
            limit:
              type: integer
              example: 10
            totalItems:
              type: integer
              example: 14
            totalPages:
              type: integer
              example: 2
            totalAvailableItems:
              type: integer
              minimum: 0
              description: >-
                Total matching records before the shared catalogue browse
                boundary.
        performanceSummary:
          type: object
          description: >-
            All-time summary, same values as `performanceSummary` on the client
            training page. The work totals (`totalReps`, `totalVolume`,
            `totalTimeSeconds`, `maxWeight`, `distinctExercises`,
            `averageVolumePerSession`) count only work actually performed:
            completed sessions (plus performances without a session) and
            completed sets.
          properties:
            sessionsTotal:
              type: integer
              example: 81
            sessionsCompleted:
              type: integer
              example: 56
            averageRating:
              type: number
              example: 7.8
            maxWeight:
              type: number
              example: 109
              description: >-
                Heaviest weight in the counted performances; assisted bodyweight
                excluded. Rounded to 0.1.
            averageVolumePerSession:
              type: number
              example: 3895.1
              description: Total volume ÷ counted sessions that have performances.
            distinctExercises:
              type: integer
              example: 59
              description: Unique exercises across the counted performances.
            totalReps:
              type: integer
              example: 1128
              description: Reps of completed sets.
            totalTimeSeconds:
              type: integer
              example: 331200
              description: Time of completed sets, whole seconds.
            totalVolume:
              type: number
              example: 218130.5
              description: Weight × reps of completed sets; assisted bodyweight adds none.
            totalActiveWorkout:
              type: integer
              example: 3
              description: Sessions currently in_progress / paused / stopped.
        muscleActivation:
          type: object
          description: Muscle heatmap aggregated from performances in 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
            total:
              type: object
              properties:
                raw:
                  type: object
                  additionalProperties:
                    type: number
                normalized:
                  type: object
                  additionalProperties:
                    type: number
                maxValue:
                  type: number
                  example: 420
                topMuscles:
                  type: array
                  items:
                    type: object
                    properties:
                      muscle:
                        type: string
                        example: Quadriceps
                      value:
                        type: number
                        example: 420
        freestyleWorkout:
          type: object
          properties:
            state:
              type: string
              enum:
                - create
                - start
                - continue
              example: continue
              description: >-
                `create` = no active session; `start` = session open but empty;
                `continue` = session has exercises logged.
            sessionId:
              type: string
              example: 67f1234567890abcdef1234
              nullable: true
            planId:
              type: string
              example: 67f1234567890abcdef1234
              nullable: true
            planMomentId:
              type: string
              example: 67f1234567890abcdef1234
              nullable: true
            status:
              type: string
              example: in_progress
            startedAt:
              type: string
              format: date-time
              example: '2026-04-12T10:00:00.000Z'
              nullable: true
        trainingSectionsAccess:
          type: object
          description: >-
            Client's current training-section visibility flags. All fields
            default to `true` when not explicitly set.
          properties:
            pageEnabled:
              type: boolean
              example: true
              description: Master toggle for the entire training page.
            trainingPlanAssignedSection:
              type: boolean
              example: true
            freestyleWorkout:
              type: boolean
              example: true
            videoLibrary:
              type: boolean
              example: true
            performanceSummary:
              type: boolean
              example: true
            muscleActivation:
              type: boolean
              example: true
            dailyTrainingNotes:
              type: boolean
              example: true
            workoutPlanLibrary:
              type: boolean
              example: true
    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.