Source of truth for implementation is the canonical schema host: https://schemas.meta-aiml.org/v3.0.0/. If any page text conflicts with canonical schema files, follow canonical files. Documentation home.

FitnessPlatform

v3.0.0

DigitalEntity

Fitness

v3 schema for digital fitness platforms that deliver training plans, workout experiences, and wellness tracking directly to users.

Top-level required

Required modules

Capability groups

Entity properties

Canonical Files

Contract URL: https://schemas.meta-aiml.org/v3.0.0/entity/fitness_platform.json

Example URL: https://schemas.meta-aiml.org/v3.0.0/examples/fitness_platform_example_schema_v3.json

Inheritance Chain

https://schemas.meta-aiml.org/v3.0.0/ontology/digital_entity.json

https://schemas.meta-aiml.org/v3.0.0/archetypes/direct_service.json

Interaction archetype

DirectService

Required Top-level Fields

These fields are enforced by JSON Schema required[] at root level.

@type

ontologicalMode

interactionArchetype

domain

name

description

deliveryFormat

capabilities

structuralMetadata

modules

Non-universal required fields

interactionArchetype

Entity-specific Properties

Keys under properties.properties dedicated to this entity contract.

goalFramework

personalizationLevel

supportsNutritionTracking

supportsWearableIntegration

trainingModes

Modules Contract

Required modules

No required modules for this entity.

Optional modules

coaching

progressTracking

workoutEngine

Capabilities Contract

Required capability groups

interaction

Optional capability groups

community

content

financial

Governance Validation Rules

Normative rule list from governanceMetadata.sdkValidationRules.

RULE-FIT-001: @type MUST equal "FitnessPlatform"

RULE-FIT-002: ontologicalMode MUST equal "DigitalEntity"

RULE-FIT-003: interactionArchetype MUST contain "DirectService"

RULE-FIT-004: capabilities.interaction MUST be present

RULE-FIT-005: structuralMetadata.topology MUST equal "binary"

RULE-FIT-006: trainingModes SHOULD be explicitly declared

Canonical Contract JSON

https://schemas.meta-aiml.org/v3.0.0/entity/fitness_platform.json

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "@context": [
    "https://schemas.meta-aiml.org/v3.0.0/context.jsonld"
  ],
  "@id": "https://schemas.meta-aiml.org/v3.0.0/entity/fitness_platform.json",
  "$id": "https://schemas.meta-aiml.org/v3.0.0/entity/fitness_platform.json",
  "@type": "FitnessPlatform",
  "schemaVersion": "3.0.0",
  "aimlVersion": "3.0.0",
  "title": "Fitness Platform Entity Schema",
  "description": "v3 schema for digital fitness platforms that deliver training plans, workout experiences, and wellness tracking directly to users.",
  "examples": [
    {
      "description": "Fitness coaching app with adaptive workout plans and wearable integration",
      "reference": "fitness_platform_example_adaptive"
    },
    {
      "description": "Digital fitness subscription with live classes and progress dashboards",
      "reference": "fitness_platform_example_live_classes"
    }
  ],
  "type": "object",
  "additionalProperties": false,
  "allOf": [
    {
      "$ref": "../ontology/digital_entity.json"
    },
    {
      "$ref": "../archetypes/direct_service.json"
    }
  ],
  "properties": {
    "@type": {
      "const": "FitnessPlatform"
    },
    "ontologicalMode": {
      "const": "DigitalEntity"
    },
    "interactionArchetype": {
      "type": "array",
      "contains": {
        "const": "DirectService"
      },
      "items": {
        "type": "string",
        "enum": [
          "DirectService"
        ]
      }
    },
    "domain": {
      "const": "Fitness"
    },
    "businessModel": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "Subscription",
          "Freemium",
          "Transactional"
        ]
      }
    },
    "deliveryFormat": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "MobileApp",
          "WebApp",
          "API"
        ]
      }
    },
    "name": {
      "$ref": "../components/multilingual_format.json#/$defs/LocalizedText"
    },
    "description": {
      "$ref": "../components/multilingual_format.json#/$defs/LocalizedText"
    },
    "shortDescription": {
      "type": "string"
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "foundingDate": {
      "type": "string",
      "format": "date"
    },
    "properties": {
      "type": "object",
      "properties": {
        "trainingModes": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "self_guided",
              "coach_led",
              "live_classes",
              "hybrid"
            ]
          }
        },
        "supportsWearableIntegration": {
          "type": "boolean"
        },
        "supportsNutritionTracking": {
          "type": "boolean"
        },
        "personalizationLevel": {
          "type": "string",
          "enum": [
            "basic",
            "adaptive",
            "ai_driven"
          ]
        },
        "goalFramework": {
          "type": "string",
          "enum": [
            "habit_based",
            "performance_based",
            "hybrid"
          ]
        }
      }
    },
    "capabilities": {
      "type": "object",
      "required": [
        "interaction"
      ],
      "properties": {
        "interaction": {
          "$ref": "../components/capability_groups.json#/$defs/InteractionCapabilities"
        },
        "content": {
          "$ref": "../components/capability_groups.json#/$defs/ContentCapabilities"
        },
        "community": {
          "$ref": "../components/capability_groups.json#/$defs/CommunityCapabilities"
        },
        "financial": {
          "$ref": "../components/capability_groups.json#/$defs/FinancialCapabilities"
        }
      }
    },
    "modules": {
      "type": "object",
      "properties": {
        "workoutEngine": {
          "type": "object",
          "properties": {
            "planBuilderEnabled": {
              "type": "boolean"
            },
            "exerciseLibrarySizeTracked": {
              "type": "boolean"
            },
            "adaptiveProgressionEnabled": {
              "type": "boolean"
            }
          }
        },
        "progressTracking": {
          "type": "object",
          "properties": {
            "goalTrackingEnabled": {
              "type": "boolean"
            },
            "streaksEnabled": {
              "type": "boolean"
            },
            "performanceTrendAnalysisEnabled": {
              "type": "boolean"
            }
          }
        },
        "coaching": {
          "type": "object",
          "properties": {
            "liveCoachingEnabled": {
              "type": "boolean"
            },
            "asynchronousFeedbackEnabled": {
              "type": "boolean"
            },
            "programAdjustmentsEnabled": {
              "type": "boolean"
            }
          }
        }
      }
    },
    "structuralMetadata": {
      "type": "object",
      "properties": {
        "topology": {
          "const": "binary"
        },
        "roles": {
          "const": [
            "user",
            "platform"
          ]
        },
        "valueSource": {
          "const": "platform_provided"
        },
        "transactionFlow": {
          "const": "direct"
        },
        "networkEffects": {
          "const": "none"
        },
        "engagementCadence": {
          "type": "string",
          "enum": [
            "daily",
            "program_based",
            "adaptive_hybrid"
          ]
        }
      }
    },
    "targetAudience": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "siteCapabilities": {
      "type": "object",
      "properties": {
        "supportedDevices": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "desktop",
              "mobile",
              "tablet"
            ]
          }
        },
        "languages": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "accessibilityFeatures": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      }
    }
  },
  "required": [
    "@type",
    "ontologicalMode",
    "interactionArchetype",
    "domain",
    "name",
    "description",
    "deliveryFormat",
    "capabilities",
    "structuralMetadata",
    "modules"
  ],
  "validationMetadata": {
    "schemaVersion": "3.0.0",
    "phase": "entity",
    "status": "draft",
    "lastValidated": "2026-02-20T12:00:00Z",
    "validator": "META-AIML QA"
  },
  "semanticAnnotations": {
    "classificationRationale": "FitnessPlatform is modeled as DigitalEntity + DirectService because training experiences and progress tooling are delivered directly by the platform.",
    "disambiguationNotes": "Different from coach marketplaces where independent providers are matched to users as primary value path."
  },
  "governanceMetadata": {
    "entityVersion": "3.0.0",
    "introducedIn": "META-AIML v3.0.0",
    "stabilityLevel": "draft",
    "sdkValidationRules": [
      "RULE-FIT-001: @type MUST equal \"FitnessPlatform\"",
      "RULE-FIT-002: ontologicalMode MUST equal \"DigitalEntity\"",
      "RULE-FIT-003: interactionArchetype MUST contain \"DirectService\"",
      "RULE-FIT-004: capabilities.interaction MUST be present",
      "RULE-FIT-005: structuralMetadata.topology MUST equal \"binary\"",
      "RULE-FIT-006: trainingModes SHOULD be explicitly declared"
    ]
  }
}

Filled Example Instance

https://schemas.meta-aiml.org/v3.0.0/examples/fitness_platform_example_schema_v3.json

{
  "@context": [
    "https://schemas.meta-aiml.org/v3.0.0/context.jsonld"
  ],
  "@id": "https://data.meta-aiml.org/v3.0.0/examples/fitness_platform/pulseforge-fitness",
  "$id": "https://data.meta-aiml.org/v3.0.0/examples/fitness_platform/pulseforge-fitness",
  "@type": "FitnessPlatform",
  "schemaVersion": "3.0.0",
  "aimlVersion": "3.0.0",
  "title": "Example Filled Fitness Platform Entity (PulseForge Fitness)",
  "ontologicalMode": "DigitalEntity",
  "interactionArchetype": [
    "DirectService"
  ],
  "domain": "Fitness",
  "businessModel": [
    "Subscription",
    "Freemium",
    "Transactional"
  ],
  "deliveryFormat": [
    "MobileApp",
    "WebApp",
    "API"
  ],
  "name": {
    "en": "PulseForge Fitness",
    "es": "PulseForge Fitness",
    "fr": "PulseForge Fitness"
  },
  "description": {
    "en": "PulseForge Fitness is a fictional digital fitness platform delivering adaptive training plans, live coaching sessions, and integrated progress tracking with wearable data ingestion.",
    "es": "PulseForge Fitness es una plataforma ficticia de fitness digital con planes adaptativos, sesiones en vivo y seguimiento de progreso con integracion de wearables.",
    "fr": "PulseForge Fitness est une plateforme fictive de fitness numerique offrant plans adaptatifs, coaching en direct et suivi de progression via wearables."
  },
  "shortDescription": {
    "en": "Digital fitness service with adaptive workouts, coaching, and progress analytics.",
    "es": "Servicio de fitness digital con entrenamientos adaptativos, coaching y analitica de progreso.",
    "fr": "Service fitness numerique avec entrainements adaptatifs, coaching et analytics de progression."
  },
  "url": "https://pulseforge-fitness.example",
  "foundingDate": "2020-01-08",
  "createdDate": "2026-02-20T21:06:00Z",
  "lastModified": "2026-02-20T21:06:00Z",
  "examples": [
    {
      "scenario": "New-year goal surge for beginner users",
      "note": "AI should personalize onboarding and recommend low-intensity progression while honoring the direct-service model and subscription constraints."
    },
    {
      "scenario": "Plateau detection in intermediate strength program",
      "note": "AI should use workout engine and coaching modules to suggest evidence-based progression adjustments and recovery windows."
    }
  ],
  "properties": {
    "trainingModes": [
      "self_guided",
      "coach_led",
      "live_classes",
      "hybrid"
    ],
    "supportsWearableIntegration": true,
    "supportsNutritionTracking": true,
    "personalizationLevel": "ai_driven",
    "goalFramework": "hybrid",
    "contactPoints": [
      {
        "contactType": "customer_service",
        "telephone": "+1-512-555-0148",
        "email": "support@pulseforge-fitness.example",
        "url": "https://pulseforge-fitness.example/help",
        "areaServed": "global",
        "availableLanguages": [
          "en",
          "es",
          "fr"
        ]
      }
    ],
    "socialProfiles": [
      {
        "platform": "instagram",
        "url": "https://instagram.com/pulseforgefitness",
        "username": "pulseforgefitness"
      },
      {
        "platform": "youtube",
        "url": "https://youtube.com/@pulseforgefitness",
        "username": "pulseforgefitness"
      }
    ],
    "identifiers": [
      {
        "type": "url",
        "value": "https://pulseforge-fitness.example"
      },
      {
        "type": "custom",
        "value": "FIT-PFF-001"
      }
    ]
  },
  "capabilities": {
    "interaction": {
      "features": [
        "messaging",
        "commenting",
        "notifications",
        "feed"
      ],
      "interactionMethods": [
        "chat",
        "in_app_messaging",
        "online_form"
      ],
      "availableActions": [
        "start_workout",
        "schedule_class",
        "log_meal",
        "message_coach"
      ],
      "hasMessaging": true,
      "hasComments": true,
      "hasRating": false,
      "hasReviews": false,
      "hasSocialGraph": false,
      "hasFeed": true,
      "hasNotifications": true,
      "hasMatching": false,
      "realTimeCommunication": true,
      "moderationEnabled": true,
      "privacyControls": [
        "private",
        "friends_only"
      ]
    },
    "content": {
      "features": [
        "publishing",
        "curation",
        "mediaHosting",
        "search",
        "categories",
        "tags",
        "archives"
      ],
      "contentTypes": [
        "workout",
        "class_replay",
        "nutrition_plan",
        "coaching_note"
      ],
      "contentFormats": [
        "text",
        "video",
        "json",
        "pdf"
      ],
      "contentAccess": [
        "member",
        "premium"
      ],
      "editorialControl": true,
      "userGeneratedContent": true,
      "mediaHosting": true,
      "searchPossible": true,
      "hasCategorization": true,
      "hasTagging": true,
      "archiveAccess": true,
      "rssFeeds": false
    },
    "community": {
      "features": [
        "groups",
        "channels",
        "communities",
        "discovery",
        "moderation",
        "membershipManagement",
        "groupEvents",
        "polls"
      ],
      "supportsGroups": true,
      "supportsChannels": true,
      "communitiesCount": 360,
      "hasDiscovery": true,
      "hasModeration": true,
      "moderationModel": "ai_assisted",
      "hasMembershipManagement": true,
      "membershipTypes": [
        "free",
        "premium",
        "coach"
      ],
      "supportsGroupEvents": true,
      "supportsPolls": true,
      "hasGovernance": true,
      "governanceModel": "centralized",
      "privacyLevels": [
        "public",
        "closed"
      ]
    },
    "financial": {
      "features": [
        "payments",
        "billing",
        "subscriptionManagement",
        "refunds"
      ],
      "paymentMethods": [
        "credit_card",
        "debit_card",
        "digital_wallet"
      ],
      "acceptsCreditCards": true,
      "currencies": [
        "USD",
        "EUR"
      ],
      "priceRange": "freemium_plus_subscription",
      "commissionModel": "fixed_price",
      "commissionRate": 0,
      "supportsSubscriptions": true,
      "supportsInvoicing": true,
      "refundPolicy": "partial_refund"
    }
  },
  "modules": {
    "workoutEngine": {
      "planBuilderEnabled": true,
      "exerciseLibrarySizeTracked": true,
      "adaptiveProgressionEnabled": true
    },
    "progressTracking": {
      "goalTrackingEnabled": true,
      "streaksEnabled": true,
      "performanceTrendAnalysisEnabled": true
    },
    "coaching": {
      "liveCoachingEnabled": true,
      "asynchronousFeedbackEnabled": true,
      "programAdjustmentsEnabled": true
    }
  },
  "structuralMetadata": {
    "topology": "binary",
    "roles": [
      "user",
      "platform"
    ],
    "valueSource": "platform_provided",
    "transactionFlow": "direct",
    "networkEffects": "none",
    "engagementCadence": "adaptive_hybrid"
  },
  "targetAudience": [
    "fitness_beginners",
    "intermediate_athletes",
    "remote_coaching_clients"
  ],
  "siteCapabilities": {
    "supportedDevices": [
      "desktop",
      "mobile",
      "tablet"
    ],
    "languages": [
      "en",
      "es",
      "fr"
    ],
    "accessibilityFeatures": [
      "keyboard_navigation",
      "screen_reader_labels",
      "text_scaling"
    ]
  },
  "validationMetadata": {
    "schemaVersion": "3.0.0",
    "phase": "example_instance",
    "status": "reference",
    "lastValidated": "2026-02-20T21:06:00Z",
    "validator": "META-AIML SDK v3"
  },
  "semanticAnnotations": {
    "classificationRationale": "FitnessPlatform is modeled as DigitalEntity plus DirectService because training and coaching workflows are first-party platform services.",
    "disambiguationNotes": "This model is not a coach marketplace where third-party providers mediate service delivery.",
    "intendedUse": "Canonical example for digital fitness and wellness products."
  },
  "governanceMetadata": {
    "entityVersion": "3.0.0",
    "introducedIn": "META-AIML v3.0.0",
    "stabilityLevel": "reference",
    "sdkValidationRules": [
      "RULE-FITX-001: @type MUST equal \"FitnessPlatform\"",
      "RULE-FITX-002: ontologicalMode MUST equal \"DigitalEntity\"",
      "RULE-FITX-003: interactionArchetype MUST contain exactly one value: \"DirectService\"",
      "RULE-FITX-004: modules.workoutEngine, modules.progressTracking, and modules.coaching MUST be present",
      "RULE-FITX-005: structuralMetadata constants MUST align with DirectService archetype",
      "RULE-FITX-006: examples MUST include at least two operational scenarios"
    ]
  }
}

All entities VirtualEventPlatform GamingPlatform