Skip to content
MSO CloudDocumentation

Dashboards and exploration

On this page

Dashboards, templates, versions and delivery, Explore, brand comparison and AI insight cards.

dashboards#

Source: apps/web/src/server/routers/dashboards.ts

Procedure Type Access Description
dashboards.list query brandProcedure —
dashboards.getOrCreateHome query brandProcedure —
dashboards.bySlug query brandProcedure —
dashboards.deckChat query brandProcedure —
dashboards.deckChatThreads query brandProcedure the reader'S own history on this deck.
dashboards.deckChatOngoing query brandProcedure The conversation a tab (or the AI tab) resumes: the reader's newest live one whose stored origin is this tab (or the deck's group), else none.
dashboards.deckChatLiveSnapshot query brandProcedure The live filters as the deck chat would state them for this turn (masked for the reader): the drawer compares a resumed thread's stored snapshot against this, never client labels.
dashboards.deckChatMessages query brandProcedure One thread's messages, oldest first — what the panel rehydrates on open.
dashboards.deckChatDeleteThread mutation rateLimitedBrandProcedure Retire one of the caller's own deck threads.
dashboards.deckDimensions query brandProcedure —
dashboards.deckRestorableCards query brandProcedure, edit_dashboard —
dashboards.create mutation rateLimitedBrandProcedure, edit_dashboard —
dashboards.createFromExplore mutation rateLimitedBrandProcedure, edit_dashboard —
dashboards.updateLayout mutation rateLimitedBrandProcedure, edit_dashboard —
dashboards.renameDashboard mutation rateLimitedBrandProcedure, edit_dashboard —
dashboards.setPageFilterBar mutation rateLimitedBrandProcedure, edit_dashboard Site/hierarchy design (2026-09) — declare (or clear) the page-level filter bar (dashboards.filter_bar).
dashboards.deleteDashboard mutation rateLimitedBrandProcedure, edit_dashboard —
dashboards.duplicate mutation rateLimitedBrandProcedure, edit_dashboard —
dashboards.addWidget mutation rateLimitedBrandProcedure, edit_dashboard —
dashboards.updateWidget mutation rateLimitedBrandProcedure, edit_dashboard —
dashboards.deleteWidget mutation rateLimitedBrandProcedure, edit_dashboard —
dashboards.createTab mutation rateLimitedBrandProcedure, edit_dashboard —
dashboards.renameTab mutation rateLimitedBrandProcedure, edit_dashboard —
dashboards.setTabFilterBar mutation rateLimitedBrandProcedure, edit_dashboard Site/hierarchy design (2026-09) — declare (or clear) the dashboard-level (tab-level) filter bar (dashboard_tabs.filter_bar).
dashboards.moveTab mutation rateLimitedBrandProcedure, edit_dashboard Re-order and/or re-parent one tab.
dashboards.deleteTab mutation rateLimitedBrandProcedure, edit_dashboard Deleting a tab never orphans a widget: the composite FK is ON DELETE SET NULL ("tab_id"), so its widgets fall back to null = the first tab and stay on screen.
dashboards.assignWidgetTab mutation rateLimitedBrandProcedure, edit_dashboard Put one widget on one tab (or back on null = the first tab).
dashboards.saveDeckDraft mutation rateLimitedBrandProcedure, edit_dashboard —
dashboards.guestPreview query brandProcedure, edit_dashboard The deck exactly as a reader holding the link receives it.

dashboardGridDraft#

Source: apps/web/src/server/routers/dashboards-grid-draft.ts

Procedure Type Access Description
dashboardGridDraft.save mutation rateLimitedBrandProcedure, edit_dashboard —

dashboardTemplates#

Source: apps/web/src/server/routers/dashboard-templates.ts

Procedure Type Access Description
dashboardTemplates.list query authedProcedure Gallery: every registry template + this org's installed-instance state.
dashboardTemplates.install mutation rateLimitedBrandProcedure, edit_dashboard —
dashboardTemplates.updatePreview query brandProcedure, edit_dashboard What the client should do about an available update (resolveTemplateUpdate, the single decision rule).
dashboardTemplates.applyUpdate mutation rateLimitedBrandProcedure, edit_dashboard —
dashboardTemplates.resetToTemplate mutation rateLimitedBrandProcedure, edit_dashboard —
dashboardTemplates.detach mutation rateLimitedBrandProcedure, edit_dashboard —

dashboardSubscriptions#

Source: apps/web/src/server/routers/dashboard-delivery.ts

Procedure Type Access Description
dashboardSubscriptions.list query authedProcedure, edit_dashboard —
dashboardSubscriptions.runs query brandProcedure, edit_dashboard —
dashboardSubscriptions.create mutation rateLimitedBrandProcedure, owner or admin, edit_dashboard —
dashboardSubscriptions.setEnabled mutation rateLimitedBrandProcedure, owner or admin, edit_dashboard —
dashboardSubscriptions.remove mutation rateLimitedBrandProcedure, owner or admin, edit_dashboard —

dashboardVersions#

Source: apps/web/src/server/routers/dashboard-delivery.ts

Procedure Type Access Description
dashboardVersions.list query authedProcedure, edit_dashboard —
dashboardVersions.restore mutation rateLimitedBrandProcedure, owner or admin, edit_dashboard —
dashboardVersions.tag mutation rateLimitedBrandProcedure, owner or admin, edit_dashboard —

insights#

Source: apps/web/src/server/routers/insights.ts

Procedure Type Access Description
insights.forWidgets query brandProcedure Fetch cached insights for a list of widget IDs.
insights.keySummary query brandProcedure Fetch the key summary for a dashboard.
insights.runDashboard mutation rateLimitedBrandProcedure, owner or admin Enqueue a dashboard analysis run.

explore#

Source: apps/web/src/server/routers/explore.ts

Procedure Type Access Description
explore.catalog query brandProcedure —
explore.query query authedProcedure —
explore.datasetCatalog query brandProcedure —
explore.dataset query brandProcedure —
explore.audienceRecords query brandProcedure —
explore.audienceRecordFilters query brandProcedure —
explore.orgDatasetQuery query authedProcedure —
explore.orgDatasetPanelOptions query authedProcedure —
explore.orgDatasetPanelItemGroups query authedProcedure Grouped item options of a pi-level control (itemGroups): the items of a panel dataset per group (a brand group), titled, optionally one shop's.
explore.orgDatasetPanelFrame query authedProcedure —

brandCompare#

Source: apps/web/src/server/routers/brand-compare.ts

Procedure Type Access Description
brandCompare.monthly query orgProcedure —

orgDatasetInsights#

Source: apps/web/src/server/routers/org-dataset-insights.ts

Procedure Type Access Description
orgDatasetInsights.forWidget query brandProcedure, view_dashboard The card as the reader sees it: the live body resolved against today's pack, and (for an editor) the parked draft and the last failure.
orgDatasetInsights.requestGeneration mutation rateLimitedBrandProcedure, edit_dashboard —
orgDatasetInsights.approveDraft mutation rateLimitedBrandProcedure, edit_dashboard Approve the parked draft: it becomes the live body, hash included.
orgDatasetInsights.saveBody mutation rateLimitedBrandProcedure, edit_dashboard —
orgDatasetInsights.discardDraft mutation rateLimitedBrandProcedure, edit_dashboard Throw away the parked draft (and the last failure note); the live body is untouched.