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.

WebApp

v3.0.0

DigitalEntity

Technology

v3 schema for generic web application products that provide software capabilities directly to users through browser-native and API-enabled interfaces.

Top-level required

Required modules

Capability groups

Entity properties

Canonical Files

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

Example URL: https://schemas.meta-aiml.org/v3.0.0/examples/web_app_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.

appCategory

releaseChannel

supportsApiAccess

supportsOfflineMode

tenantModel

Modules Contract

Required modules

No required modules for this entity.

Optional modules

authentication

observability

performance

Capabilities Contract

Required capability groups

interaction

Optional capability groups

commerce

content

financial

Governance Validation Rules

Normative rule list from governanceMetadata.sdkValidationRules.

RULE-WEB-001: @type MUST equal "WebApp"

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

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

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

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

RULE-WEB-006: deliveryFormat MUST include "WebApp"

Canonical Contract JSON

https://schemas.meta-aiml.org/v3.0.0/entity/web_app.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/web_app.json",
  "$id": "https://schemas.meta-aiml.org/v3.0.0/entity/web_app.json",
  "@type": "WebApp",
  "schemaVersion": "3.0.0",
  "aimlVersion": "3.0.0",
  "title": "Web App Entity Schema",
  "description": "v3 schema for generic web application products that provide software capabilities directly to users through browser-native and API-enabled interfaces.",
  "examples": [
    {
      "description": "Workflow web app with account-based access and API integrations",
      "reference": "web_app_example_workflow"
    },
    {
      "description": "Consumer web utility with responsive UI and usage-based service tiers",
      "reference": "web_app_example_consumer_utility"
    }
  ],
  "type": "object",
  "additionalProperties": false,
  "allOf": [
    {
      "$ref": "../ontology/digital_entity.json"
    },
    {
      "$ref": "../archetypes/direct_service.json"
    }
  ],
  "properties": {
    "@type": {
      "const": "WebApp"
    },
    "ontologicalMode": {
      "const": "DigitalEntity"
    },
    "interactionArchetype": {
      "type": "array",
      "contains": {
        "const": "DirectService"
      },
      "items": {
        "type": "string",
        "enum": [
          "DirectService"
        ]
      }
    },
    "domain": {
      "const": "Technology"
    },
    "businessModel": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "Subscription",
          "Freemium",
          "Transactional",
          "UsageBased"
        ]
      }
    },
    "deliveryFormat": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "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": {
        "appCategory": {
          "type": "string",
          "enum": [
            "consumer",
            "business",
            "developer",
            "internal_tool"
          ]
        },
        "tenantModel": {
          "type": "string",
          "enum": [
            "single_tenant",
            "multi_tenant",
            "hybrid"
          ]
        },
        "supportsOfflineMode": {
          "type": "boolean"
        },
        "supportsApiAccess": {
          "type": "boolean"
        },
        "releaseChannel": {
          "type": "string",
          "enum": [
            "stable",
            "beta",
            "canary"
          ]
        }
      }
    },
    "capabilities": {
      "type": "object",
      "required": [
        "interaction"
      ],
      "properties": {
        "interaction": {
          "$ref": "../components/capability_groups.json#/$defs/InteractionCapabilities"
        },
        "content": {
          "$ref": "../components/capability_groups.json#/$defs/ContentCapabilities"
        },
        "financial": {
          "$ref": "../components/capability_groups.json#/$defs/FinancialCapabilities"
        },
        "commerce": {
          "$ref": "../components/capability_groups.json#/$defs/CommerceCapabilities"
        }
      }
    },
    "modules": {
      "type": "object",
      "properties": {
        "authentication": {
          "type": "object",
          "properties": {
            "ssoEnabled": {
              "type": "boolean"
            },
            "mfaEnabled": {
              "type": "boolean"
            },
            "passwordlessEnabled": {
              "type": "boolean"
            }
          }
        },
        "performance": {
          "type": "object",
          "properties": {
            "cachingEnabled": {
              "type": "boolean"
            },
            "cdnEnabled": {
              "type": "boolean"
            },
            "realUserMonitoringEnabled": {
              "type": "boolean"
            }
          }
        },
        "observability": {
          "type": "object",
          "properties": {
            "errorTrackingEnabled": {
              "type": "boolean"
            },
            "traceCollectionEnabled": {
              "type": "boolean"
            },
            "auditLogsEnabled": {
              "type": "boolean"
            }
          }
        }
      }
    },
    "structuralMetadata": {
      "type": "object",
      "properties": {
        "topology": {
          "const": "binary"
        },
        "roles": {
          "const": [
            "user",
            "platform"
          ]
        },
        "valueSource": {
          "const": "platform_provided"
        },
        "transactionFlow": {
          "const": "direct"
        },
        "networkEffects": {
          "const": "none"
        },
        "runtimeModel": {
          "type": "string",
          "enum": [
            "browser_native",
            "browser_plus_api",
            "edge_distributed"
          ]
        }
      }
    },
    "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": "WebApp is modeled as DigitalEntity + DirectService because the application itself directly delivers user-facing functionality over software channels.",
    "disambiguationNotes": "Different from content-first publisher platforms. This schema emphasizes functional software service delivery."
  },
  "governanceMetadata": {
    "entityVersion": "3.0.0",
    "introducedIn": "META-AIML v3.0.0",
    "stabilityLevel": "draft",
    "sdkValidationRules": [
      "RULE-WEB-001: @type MUST equal \"WebApp\"",
      "RULE-WEB-002: ontologicalMode MUST equal \"DigitalEntity\"",
      "RULE-WEB-003: interactionArchetype MUST contain \"DirectService\"",
      "RULE-WEB-004: capabilities.interaction MUST be present",
      "RULE-WEB-005: structuralMetadata.topology MUST equal \"binary\"",
      "RULE-WEB-006: deliveryFormat MUST include \"WebApp\""
    ]
  }
}

Filled Example Instance

https://schemas.meta-aiml.org/v3.0.0/examples/web_app_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/web_app/flowdesk-workspace",
  "$id": "https://data.meta-aiml.org/v3.0.0/examples/web_app/flowdesk-workspace",
  "@type": "WebApp",
  "schemaVersion": "3.0.0",
  "aimlVersion": "3.0.0",
  "title": "Example Filled Web App Entity (FlowDesk Workspace)",
  "ontologicalMode": "DigitalEntity",
  "interactionArchetype": [
    "DirectService"
  ],
  "domain": "Technology",
  "businessModel": [
    "Subscription",
    "Freemium",
    "UsageBased"
  ],
  "deliveryFormat": [
    "WebApp",
    "API"
  ],
  "name": {
    "en": "FlowDesk Workspace",
    "es": "FlowDesk Workspace",
    "fr": "FlowDesk Workspace"
  },
  "description": {
    "en": "FlowDesk Workspace is a fictional browser-first operations web application that combines task orchestration, workflow automations, and API integrations for distributed teams.",
    "es": "FlowDesk Workspace es una aplicacion web ficticia orientada al navegador que combina orquestacion de tareas, automatizaciones de flujo e integraciones API para equipos distribuidos.",
    "fr": "FlowDesk Workspace est une application web fictive orientee navigateur combinant orchestration des taches, automatisations de workflow et integrations API pour equipes distribuees."
  },
  "shortDescription": {
    "en": "Browser-native operations app with workflow automation and API access.",
    "es": "Aplicacion de operaciones web con automatizacion de flujos y acceso API.",
    "fr": "Application web d operations avec automatisation des workflows et acces API."
  },
  "url": "https://flowdesk-workspace.example",
  "foundingDate": "2019-04-10",
  "createdDate": "2026-02-20T23:55:00Z",
  "lastModified": "2026-02-20T23:55:00Z",
  "examples": [
    {
      "scenario": "Quarter-end planning cycle across multi-team workspace",
      "note": "AI should use interaction and content capabilities to organize high-volume task updates, notification rules, and workspace-level dashboards."
    },
    {
      "scenario": "API-driven synchronization with ERP and CRM systems",
      "note": "AI should prioritize supportsApiAccess and observability modules to keep automation reliability and traceability under direct-service assumptions."
    }
  ],
  "properties": {
    "appCategory": "business",
    "tenantModel": "multi_tenant",
    "supportsOfflineMode": true,
    "supportsApiAccess": true,
    "releaseChannel": "stable",
    "contactPoints": [
      {
        "contactType": "support",
        "telephone": "+1-312-555-0138",
        "email": "support@flowdesk-workspace.example",
        "url": "https://flowdesk-workspace.example/help",
        "areaServed": "global",
        "availableLanguages": [
          "en",
          "es",
          "fr"
        ]
      },
      {
        "contactType": "sales",
        "telephone": "+1-312-555-0165",
        "email": "sales@flowdesk-workspace.example",
        "url": "https://flowdesk-workspace.example/pricing",
        "areaServed": "global",
        "availableLanguages": [
          "en"
        ]
      }
    ],
    "socialProfiles": [
      {
        "platform": "linkedin",
        "url": "https://www.linkedin.com/company/flowdesk-workspace",
        "username": "flowdesk-workspace"
      },
      {
        "platform": "github",
        "url": "https://github.com/flowdesk-workspace",
        "username": "flowdesk-workspace"
      }
    ],
    "identifiers": [
      {
        "type": "url",
        "value": "https://flowdesk-workspace.example"
      },
      {
        "type": "custom",
        "value": "WEBAPP-FDW-001"
      }
    ]
  },
  "capabilities": {
    "interaction": {
      "features": [
        "messaging",
        "commenting",
        "feed",
        "notifications"
      ],
      "interactionMethods": [
        "online_form",
        "chat",
        "in_app_messaging",
        "email"
      ],
      "availableActions": [
        "create_workspace",
        "assign_task",
        "run_automation",
        "share_dashboard",
        "invite_member"
      ],
      "hasMessaging": true,
      "hasComments": true,
      "hasRating": false,
      "hasReviews": false,
      "hasSocialGraph": false,
      "hasFeed": true,
      "hasNotifications": true,
      "hasMatching": false,
      "realTimeCommunication": true,
      "moderationEnabled": true,
      "privacyControls": [
        "private",
        "semi_anonymous"
      ]
    },
    "content": {
      "features": [
        "publishing",
        "search",
        "categories",
        "tags",
        "archives"
      ],
      "contentTypes": [
        "workflow_template",
        "dashboard",
        "task_document",
        "audit_export"
      ],
      "contentFormats": [
        "json",
        "csv",
        "text",
        "markdown"
      ],
      "contentAccess": [
        "member",
        "restricted"
      ],
      "editorialControl": true,
      "userGeneratedContent": true,
      "mediaHosting": false,
      "searchPossible": true,
      "hasCategorization": true,
      "hasTagging": true,
      "archiveAccess": true,
      "rssFeeds": false
    },
    "financial": {
      "features": [
        "payments",
        "invoicing",
        "billing",
        "subscriptionManagement",
        "refunds"
      ],
      "paymentMethods": [
        "credit_card",
        "bank_transfer",
        "invoice_terms"
      ],
      "acceptsCreditCards": true,
      "currencies": [
        "USD",
        "EUR"
      ],
      "priceRange": "seat_tiered",
      "commissionModel": "fixed_price",
      "commissionRate": 0,
      "supportsSubscriptions": true,
      "supportsInvoicing": true,
      "refundPolicy": "partial_refund"
    },
    "commerce": {
      "features": [
        "productCatalog",
        "pricing",
        "checkout",
        "search",
        "filtering"
      ],
      "hasProductCatalog": true,
      "catalogSize": 4,
      "supportsCart": false,
      "supportsCheckout": true,
      "hasOrderTracking": true,
      "recommendationEngine": false,
      "vendorManagement": false,
      "searchCapability": true,
      "filteringOptions": [
        "plan_tier",
        "seat_count",
        "feature_pack"
      ]
    }
  },
  "modules": {
    "authentication": {
      "ssoEnabled": true,
      "mfaEnabled": true,
      "passwordlessEnabled": true
    },
    "performance": {
      "cachingEnabled": true,
      "cdnEnabled": true,
      "realUserMonitoringEnabled": true
    },
    "observability": {
      "errorTrackingEnabled": true,
      "traceCollectionEnabled": true,
      "auditLogsEnabled": true
    }
  },
  "structuralMetadata": {
    "topology": "binary",
    "roles": [
      "user",
      "platform"
    ],
    "valueSource": "platform_provided",
    "transactionFlow": "direct",
    "networkEffects": "none",
    "runtimeModel": "browser_plus_api"
  },
  "targetAudience": [
    "operations_teams",
    "project_managers",
    "startup_founders",
    "mid_market_companies"
  ],
  "siteCapabilities": {
    "supportedDevices": [
      "desktop",
      "mobile",
      "tablet"
    ],
    "languages": [
      "en",
      "es",
      "fr"
    ],
    "accessibilityFeatures": [
      "keyboard_navigation",
      "screen_reader_labels",
      "text_scaling",
      "high_contrast_mode"
    ]
  },
  "validationMetadata": {
    "schemaVersion": "3.0.0",
    "phase": "example_instance",
    "status": "reference",
    "lastValidated": "2026-02-20T23:55:00Z",
    "validator": "META-AIML SDK v3"
  },
  "semanticAnnotations": {
    "classificationRationale": "WebApp is modeled as DigitalEntity plus DirectService because software functionality is delivered directly by the platform to authenticated users over browser and API interfaces.",
    "disambiguationNotes": "This example is not a marketplace or social graph platform. It represents first-party software delivery with operational workflow focus.",
    "intendedUse": "Canonical filled reference for generic business web application entities in static META-AIML v3 deployments."
  },
  "governanceMetadata": {
    "entityVersion": "3.0.0",
    "introducedIn": "META-AIML v3.0.0",
    "stabilityLevel": "reference",
    "sdkValidationRules": [
      "RULE-WAEX-001: @type MUST equal \"WebApp\".",
      "RULE-WAEX-002: ontologicalMode MUST equal \"DigitalEntity\".",
      "RULE-WAEX-003: interactionArchetype MUST contain exactly one value: \"DirectService\".",
      "RULE-WAEX-004: properties.supportsApiAccess SHOULD be true for automation-centric web apps.",
      "RULE-WAEX-005: structuralMetadata constants MUST align with DirectService archetype.",
      "RULE-WAEX-006: examples MUST include at least two operational scenarios."
    ]
  }
}

All entities GenerativeAIPlatform WebsiteServices