Insites API Documentation

Every Insites Instance comes with built-in API documentation that is automatically generated based on the modules installed and the endpoints available. This is your go-to reference for understanding how external systems can interact with your Instance. You do not need to write or maintain this documentation yourself; Insites generates it for you.

Accessing the API Documentation

1. Navigate to API from the main menu.
2. Select Insites API Endpoints.

This opens the API documentation page at /admin/api.

What the API Documentation Includes

• Module Endpoints - Every installed module that exposes API endpoints is listed in the sidebar. You can browse endpoints by module, making it easy to find what you need.
• Request Formats - Each endpoint shows the HTTP method, URL, and an example HTTP request you can copy directly into your integration or testing tool.
• Controller Requests - For developers, each endpoint also shows how to call the underlying logic directly from Liquid templates using the function tag.
• Response Examples - View example responses for each endpoint, showing the data structure you can expect back so you can build your integration with confidence.
• Authentication - The documentation covers how to authenticate your API requests, including the authentication methods supported by your Instance.
• Module Versions - A dedicated page shows all installed module versions on your Instance, giving you a clear picture of what is running.

Using the Documentation

The API documentation is dynamic. It reflects the actual modules and endpoints installed on your specific Instance, so different Instances may show different endpoints depending on their installed modules. This means the documentation is always accurate to your Instance rather than a generic reference.

The documentation includes a theme switcher so you can view it in light or dark mode, and a searchable sidebar so you can quickly find the endpoint you are looking for. Use the sidebar to jump between modules and drill into individual endpoints.