Documentation Index
Fetch the complete documentation index at: https://docs.explo.co/llms.txt
Use this file to discover all available pages before exploring further.
You may consume any of the following events that Explo can emit.
sendVariableUpdatedEvent
Description:
Sent when a new value is selected for a variable from a dashboard Element.
Output Parameters:
| Parameter | Type | Description |
|---|
| varName | string | Name of the variable updated |
| newValue | any | New value of the variable |
{
"detail": {
"varName": "string",
"newValue": "any"
}
}
dashboardReadyToLoad
Description:
Sent when dashboard information has been loaded and the dashboard itself is ready to render and to start loading data.
Output Parameters:
| Parameter | Type | Description |
|---|
| dashboardId | string | ID of the dashboard from the URL param or HTML attribute. Empty string if not provided |
| dashboardHeight | number | Estimated height in pixels of the dashboard. Use dashboardLoaded and dashboardUpdated events to get the actual height |
{
"detail": {
"dashboardId": "string",
"dashboardHeight": 0
}
}
dashboardLoaded
Description:
Sent when all initial data for a dashboard has been loaded.
Output Parameters:
| Parameter | Type | Description |
|---|
| dashboardId | string | ID of the dashboard from the URL param or HTML attribute. Empty string if not provided |
| dashboardHeight | number | Full height in pixels of the dashboard. Use to set the height of the iframe or Web Component |
| loadTime | number | Time in milliseconds it took to fetch all data and render the dashboard. Does not include asset loading or component startup time. |
{
"detail": {
"dashboardId": "exampleDashboardId",
"dashboardHeight": 100,
"loadTime": 100
}
}
dashboardUpdated
Description:
Sent when the contents of the dashboard changes.
Output Parameters:
| Parameter | Type | Description |
|---|
| dashboardId | string | ID of the dashboard from the URL param or HTML attribute. Empty string if not provided |
| dashboardHeight | number | Full height in pixels of the dashboard. Use to set the height of the iframe or Web Component |
{
"detail": {
"dashboardId": "exampleDashboardId",
"dashboardHeight": 100
}
}
analyticsEventFired
Description:
Fires when one of the selected actions on the Analytics settings page has been performed.
Refer to the analytics events documentation for more details.
customerJwtExpired
Description:
Fires when the current JWT expires. Refer to the
updateCustomerJwt event
for programmatically updating the JWT.
error
Description:
Sent when the dashboard or report builder encounters an error. Please reach out to Explo support if you want this enabled for your workspace.
Output Example:
{
detail: {
error: "Error message",
user_id: "123", // Unique identifier for end user
properties: {
dashboard_type: "iframe",
embed_source: "iframe",
team_id: 1,
team_name: "Explo",
customer_id: 1,
customer_name: "Customer 1",
customer_provided_id: "1",
// If error occurred in Report Builder:
report_builder_id: 15, // Report Builder ID
report_builder_name: "hello", // Report Builder Name
report_name: "my report" // Report Name
report_type: 'BUILT_IN' // 'BUILT_IN' or 'CUSTOMER_REPORT'
view_name: "my report" // View Name
// If error occurred in Dashboard:
dashboard_template_id: 12,
dashboard_template_name: "hello",
data_panel_id: "fdasf",
// If error occured on dataset
dataset_id: 123,
},
},
}
dashboardFailed
Description:
Sent when the dashboard embed fails to load entirely. This is not a data querying issue, but rather an embedding issue. Usually this is because of an expired or misconfigured JWT or an invalid embed_id / customer_token.
reportBuilderReadyToLoad
Description:
Sent when report builder information has been loaded and the report builder itself is ready to render and to start loading data.
Output Parameters:
| Parameter | Type | Description |
|---|
| reportBuilderId | string | Embed ID of the report builder |
{
"detail": {
"reportBuilderId": "string"
}
}
reportBuilderFailed
Description:
Sent when the report builder embed fails to load entirely. This is not a data querying issue, but rather an embedding issue. Usually this is because of an expired or misconfigured JWT or an invalid embed_id / customer_token.
