Builder API
Build insights, dashboards, and visual canvases with the Mythic Analytics Builder API.
Overview
The Builder API powers the Mythic Analytics visual workspace. Use it to create insights with saved queries, assemble dashboards with configurable layouts, and build canvas-based analytics flows with tracked nodes and edges.
Base URL
All endpoints share the same base URL and version prefix.
https://api.mythic-analytics.com/api/v1
Response envelope
All endpoints return a JSON envelope.
Whether the request succeeded.
Resource payload. Shape depends on the endpoint.
Total number of matching resources. Present on list endpoints.
Error message on failed requests.
Key concepts
| Concept | Description |
|---|---|
| Insight | A saved analytics query with visualization settings |
| Dashboard | A configurable grid of insights with layout control |
| Canvas | A visual node-and-edge workspace for mapping analytics flows |
| Node | A canvas element representing a page, event, or conversion point |
| Edge | A connection between two canvas nodes showing user flow |
| Data Connection | An external data source available for queries |
Versioning
Canvases support full version history. Each publish creates an immutable version snapshot. You can list versions and rollback to any previous version.
Error handling
| Status | Meaning |
|---|---|
400 | Invalid JSON, missing required fields, or validation error |
401 | Admin key missing or invalid |
404 | Resource not found |
500 | Internal server error |
502 | Upstream integration error (e.g., GHL API) |
Check both the HTTP status code and the error field in the response body for programmatic error handling.
Last updated today