Assets Module

The Assets module (insites_assets) provides file and folder management for Insites instances. This guide covers the module architecture, v2 API endpoints, data structures, and integration patterns for developers.

Module Information

v2 API Endpoints

The Assets module exposes seven v2 API endpoints. All endpoints require a valid instance API key passed in the Authorization header. For full API documentation including request and response examples, visit /admin/api.

Asset Endpoints

Folder Endpoints

Data Structures

Asset Object

Folder Object

Metadata Object

Rendering Assets

Assets can be rendered in your pages and templates using Liquid tags or direct URLs.

Liquid Tag

Use the asset_url Liquid filter to generate a URL for an asset:

{{ 'path/to/file.png' | asset_url }}

You can copy the ready-to-use Liquid code snippet from the file detail panel in the Assets admin interface.

Direct URL

Each asset has a direct CDN URL that can be used in Markdown, HTML, or external applications. The URL is available in the file detail panel under the URL field.

Event Stream Integration

The Assets module integrates with the Insites Event Stream to track all file and folder activity. Events are created server-side when files or folders are added, edited, deleted, archived, or restored. Each event records the administrator, the asset name, and a timestamp.

The Event Stream is accessible from the Assets sidebar under Event Stream.