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.

FileHosting

v3.0.0

DigitalEntity

Technology

v3 schema for cloud file hosting platforms that provide storage, sharing, synchronization, and file lifecycle control directly to users and organizations.

Top-level required

Required modules

Capability groups

Entity properties

Canonical Files

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

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

defaultRetentionMode

storageClasses

supportsClientSideEncryption

supportsExternalLinkSharing

supportsVersionHistory

Modules Contract

Required modules

No required modules for this entity.

Optional modules

accessControl

storage

sync

Capabilities Contract

Required capability groups

interaction

Optional capability groups

commerce

content

financial

Governance Validation Rules

Normative rule list from governanceMetadata.sdkValidationRules.

RULE-FH-001: @type MUST equal "FileHosting"

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

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

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

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

RULE-FH-006: storageClasses SHOULD be explicitly declared

Canonical Contract JSON

https://schemas.meta-aiml.org/v3.0.0/entity/file_hosting.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/file_hosting.json",
  "$id": "https://schemas.meta-aiml.org/v3.0.0/entity/file_hosting.json",
  "@type": "FileHosting",
  "schemaVersion": "3.0.0",
  "aimlVersion": "3.0.0",
  "title": "File Hosting Entity Schema",
  "description": "v3 schema for cloud file hosting platforms that provide storage, sharing, synchronization, and file lifecycle control directly to users and organizations.",
  "examples": [
    {
      "description": "Cloud storage platform with version history and secure link sharing",
      "reference": "file_hosting_example_cloud_storage"
    },
    {
      "description": "Enterprise file repository with retention rules and access governance",
      "reference": "file_hosting_example_enterprise_repository"
    }
  ],
  "type": "object",
  "additionalProperties": false,
  "allOf": [
    {
      "$ref": "../ontology/digital_entity.json"
    },
    {
      "$ref": "../archetypes/direct_service.json"
    }
  ],
  "properties": {
    "@type": {
      "const": "FileHosting"
    },
    "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",
          "UsageBased"
        ]
      }
    },
    "deliveryFormat": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "WebApp",
          "MobileApp",
          "DesktopApp",
          "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": {
        "storageClasses": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "standard",
              "archive",
              "cold",
              "compliance"
            ]
          }
        },
        "supportsVersionHistory": {
          "type": "boolean"
        },
        "supportsExternalLinkSharing": {
          "type": "boolean"
        },
        "supportsClientSideEncryption": {
          "type": "boolean"
        },
        "defaultRetentionMode": {
          "type": "string",
          "enum": [
            "manual",
            "time_based",
            "policy_based"
          ]
        }
      }
    },
    "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": {
        "storage": {
          "type": "object",
          "properties": {
            "quotaManagementEnabled": {
              "type": "boolean"
            },
            "tieringPoliciesEnabled": {
              "type": "boolean"
            },
            "lifecycleTransitionsEnabled": {
              "type": "boolean"
            }
          }
        },
        "sync": {
          "type": "object",
          "properties": {
            "deltaSyncEnabled": {
              "type": "boolean"
            },
            "selectiveSyncEnabled": {
              "type": "boolean"
            },
            "conflictResolutionPolicies": {
              "type": "boolean"
            }
          }
        },
        "accessControl": {
          "type": "object",
          "properties": {
            "roleBasedPermissionsEnabled": {
              "type": "boolean"
            },
            "temporaryLinksEnabled": {
              "type": "boolean"
            },
            "downloadRestrictionsEnabled": {
              "type": "boolean"
            }
          }
        }
      }
    },
    "structuralMetadata": {
      "type": "object",
      "properties": {
        "topology": {
          "const": "binary"
        },
        "roles": {
          "const": [
            "user",
            "platform"
          ]
        },
        "valueSource": {
          "const": "platform_provided"
        },
        "transactionFlow": {
          "const": "direct"
        },
        "networkEffects": {
          "const": "none"
        },
        "dataDurabilityTiering": {
          "type": "string",
          "enum": [
            "single_tier",
            "multi_tier",
            "adaptive"
          ]
        }
      }
    },
    "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": "FileHosting is modeled as DigitalEntity + DirectService because storage and synchronization capabilities are provided directly by the platform.",
    "disambiguationNotes": "Different from decentralized protocol storage networks and from content marketplaces."
  },
  "governanceMetadata": {
    "entityVersion": "3.0.0",
    "introducedIn": "META-AIML v3.0.0",
    "stabilityLevel": "draft",
    "sdkValidationRules": [
      "RULE-FH-001: @type MUST equal \"FileHosting\"",
      "RULE-FH-002: ontologicalMode MUST equal \"DigitalEntity\"",
      "RULE-FH-003: interactionArchetype MUST contain \"DirectService\"",
      "RULE-FH-004: capabilities.interaction MUST be present",
      "RULE-FH-005: structuralMetadata.topology MUST equal \"binary\"",
      "RULE-FH-006: storageClasses SHOULD be explicitly declared"
    ]
  }
}

Filled Example Instance

https://schemas.meta-aiml.org/v3.0.0/examples/file_hosting_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/file_hosting/skyvault-drive",
  "$id": "https://data.meta-aiml.org/v3.0.0/examples/file_hosting/skyvault-drive",
  "@type": "FileHosting",
  "schemaVersion": "3.0.0",
  "aimlVersion": "3.0.0",
  "title": "Example Filled File Hosting Entity (SkyVault Drive)",
  "ontologicalMode": "DigitalEntity",
  "interactionArchetype": [
    "DirectService"
  ],
  "domain": "Technology",
  "businessModel": [
    "Subscription",
    "Freemium",
    "UsageBased"
  ],
  "deliveryFormat": [
    "WebApp",
    "MobileApp",
    "DesktopApp",
    "API"
  ],
  "name": {
    "en": "SkyVault Drive",
    "es": "SkyVault Drive",
    "fr": "SkyVault Drive"
  },
  "description": {
    "en": "SkyVault Drive is a fictional cloud file hosting platform delivering secure storage, synchronized access, granular sharing policies, and lifecycle retention controls for teams and individuals.",
    "es": "SkyVault Drive es una plataforma ficticia de file hosting con almacenamiento seguro, sincronizacion y politicas granulares de comparticion para equipos e individuos.",
    "fr": "SkyVault Drive est une plateforme fictive de stockage de fichiers cloud offrant synchronisation, partage fin et politiques de retention pour equipes et particuliers."
  },
  "shortDescription": {
    "en": "Cloud file hosting with secure sharing, sync clients, and lifecycle policy controls.",
    "es": "File hosting en la nube con comparticion segura, clientes de sincronizacion y politicas de ciclo de vida.",
    "fr": "Hebergement de fichiers cloud avec partage securise, synchro multi-clients et politiques de retention."
  },
  "url": "https://skyvault-drive.example",
  "foundingDate": "2017-05-22",
  "createdDate": "2026-02-20T21:04:00Z",
  "lastModified": "2026-02-20T21:04:00Z",
  "examples": [
    {
      "scenario": "Rapid document migration from legacy network storage",
      "note": "AI should prioritize onboarding and tiering policies, including lifecycle transitions and permission mapping for shared folders."
    },
    {
      "scenario": "Incident response for accidental public link exposure",
      "note": "AI should use accessControl and temporary link policies to recommend revocation and remediation actions."
    }
  ],
  "properties": {
    "storageClasses": [
      "standard",
      "archive",
      "cold",
      "compliance"
    ],
    "supportsVersionHistory": true,
    "supportsExternalLinkSharing": true,
    "supportsClientSideEncryption": true,
    "defaultRetentionMode": "policy_based",
    "contactPoints": [
      {
        "contactType": "support",
        "telephone": "+1-408-555-0112",
        "email": "support@skyvault-drive.example",
        "url": "https://skyvault-drive.example/help",
        "areaServed": "global",
        "availableLanguages": [
          "en",
          "es",
          "fr"
        ]
      }
    ],
    "socialProfiles": [
      {
        "platform": "linkedin",
        "url": "https://www.linkedin.com/company/skyvault-drive",
        "username": "skyvault-drive"
      },
      {
        "platform": "github",
        "url": "https://github.com/skyvault-drive",
        "username": "skyvault-drive"
      }
    ],
    "identifiers": [
      {
        "type": "url",
        "value": "https://skyvault-drive.example"
      },
      {
        "type": "custom",
        "value": "FH-SVD-001"
      }
    ]
  },
  "capabilities": {
    "interaction": {
      "features": [
        "messaging",
        "notifications"
      ],
      "interactionMethods": [
        "online_form",
        "chat",
        "email"
      ],
      "availableActions": [
        "upload_file",
        "share_link",
        "manage_permissions",
        "restore_version"
      ],
      "hasMessaging": true,
      "hasComments": false,
      "hasRating": false,
      "hasReviews": false,
      "hasSocialGraph": false,
      "hasFeed": false,
      "hasNotifications": true,
      "hasMatching": false,
      "realTimeCommunication": true,
      "moderationEnabled": true,
      "privacyControls": [
        "private"
      ]
    },
    "content": {
      "features": [
        "mediaHosting",
        "search",
        "categories",
        "tags",
        "archives"
      ],
      "contentTypes": [
        "document",
        "image",
        "video",
        "archive"
      ],
      "contentFormats": [
        "binary",
        "pdf",
        "jpg",
        "mp4"
      ],
      "contentAccess": [
        "member",
        "restricted"
      ],
      "editorialControl": false,
      "userGeneratedContent": true,
      "mediaHosting": true,
      "searchPossible": true,
      "hasCategorization": true,
      "hasTagging": true,
      "archiveAccess": true,
      "rssFeeds": false
    },
    "financial": {
      "features": [
        "payments",
        "invoicing",
        "billing",
        "subscriptionManagement"
      ],
      "paymentMethods": [
        "credit_card",
        "bank_transfer",
        "invoice_terms"
      ],
      "acceptsCreditCards": true,
      "currencies": [
        "USD",
        "EUR"
      ],
      "priceRange": "storage_tiered",
      "commissionModel": "fixed_price",
      "commissionRate": 0,
      "supportsSubscriptions": true,
      "supportsInvoicing": true,
      "refundPolicy": "partial_refund"
    },
    "commerce": {
      "features": [
        "pricing",
        "checkout",
        "filtering"
      ],
      "hasProductCatalog": true,
      "catalogSize": 6,
      "supportsCart": false,
      "supportsCheckout": true,
      "hasOrderTracking": true,
      "recommendationEngine": false,
      "vendorManagement": false,
      "searchCapability": true,
      "filteringOptions": [
        "storage_tier",
        "retention_policy"
      ]
    }
  },
  "modules": {
    "storage": {
      "quotaManagementEnabled": true,
      "tieringPoliciesEnabled": true,
      "lifecycleTransitionsEnabled": true
    },
    "sync": {
      "deltaSyncEnabled": true,
      "selectiveSyncEnabled": true,
      "conflictResolutionPolicies": true
    },
    "accessControl": {
      "roleBasedPermissionsEnabled": true,
      "temporaryLinksEnabled": true,
      "downloadRestrictionsEnabled": true
    }
  },
  "structuralMetadata": {
    "topology": "binary",
    "roles": [
      "user",
      "platform"
    ],
    "valueSource": "platform_provided",
    "transactionFlow": "direct",
    "networkEffects": "none",
    "dataDurabilityTiering": "multi_tier"
  },
  "targetAudience": [
    "individual_users",
    "remote_teams",
    "it_administrators"
  ],
  "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:04:00Z",
    "validator": "META-AIML SDK v3"
  },
  "semanticAnnotations": {
    "classificationRationale": "FileHosting is modeled as DigitalEntity plus DirectService because file storage and synchronization are first-party platform services.",
    "disambiguationNotes": "This model is not a peer-to-peer protocol network. User assets are managed under platform-defined controls.",
    "intendedUse": "Canonical example for cloud storage and file hosting services."
  },
  "governanceMetadata": {
    "entityVersion": "3.0.0",
    "introducedIn": "META-AIML v3.0.0",
    "stabilityLevel": "reference",
    "sdkValidationRules": [
      "RULE-FHXX-001: @type MUST equal \"FileHosting\"",
      "RULE-FHXX-002: ontologicalMode MUST equal \"DigitalEntity\"",
      "RULE-FHXX-003: interactionArchetype MUST contain exactly one value: \"DirectService\"",
      "RULE-FHXX-004: modules.storage, modules.sync, and modules.accessControl MUST be present",
      "RULE-FHXX-005: structuralMetadata constants MUST align with DirectService archetype",
      "RULE-FHXX-006: examples MUST include at least two operational scenarios"
    ]
  }
}

All entities SocialNetwork GenerativeAIPlatform