• Documentation
    • Search documentation
    karat

    +

    K

    API Reference ↗
    Ontology buildingAction typesUpload media

    Upload media

    Actions support uploading media files using an action form or table. For most use cases in Foundry, uploading to media reference properties is the recommended method.

    Media reference properties (backed by media sets) offer several advantages over attachment properties:

    • Scalability: Support for billions of files with efficient storage and retrieval.
    • Built-in transformations: Many media transformations and LLM capabilities are supported and easy to use out of the box.
    • Advanced previews: Built-in rendering and rich preview functionality for supported formats.
    • Format support: Support for tailored workflows on both standard formats and specialized formats, such as NITF, GeoTIFF, and DICOM.

    Users can upload media files via a file-picker interface, with files persisted to the media set upon successful action submission.

    Format conversions only happen after the action completes and the media file has been uploaded to the media set.

    Configuration

    For detailed instructions on configuring media reference properties and setting up media upload actions, see Configure media reference properties and Upload media.

    Permissions

    Permissions for uploading media via an action are managed by the action submission criteria. If users satisfy the action submission criteria, they do not need any permissions on the backing media set to upload media.

    Edit permission on a media set will be checked when it is added to an object type or referenced by an action type for the first time. Adding a media set to your ontology delegates access control from the media set to the ontology. This means that anyone who can manage actions on the object type, can control who is able to upload media to the media set.