Dashboard
A Dashboard is one unified view of a scope, rendered as Markdown for Agents, screens for Humans, and JSON for native clients.
Properties
| Property | Type | Required | Description |
|---|---|---|---|
scope | string | required | What it views, such as a Studio, a Startup, a Team, or a Role. |
Object
{
"$id": "https: //api.sb/ tutorloop.com/ dashboards/ dashboard_1",
"$type": "Dashboard",
"scope": "Startup"
}Relationships
- A Dashboard is presented in one App: an App opens on Dashboards for the people signed in to it.
presentedIn, inversepresents. - A Dashboard shows many Metrics: a Dashboard reads out Metrics, each computed from Events and never typed in.
shows, inverseshownOn. - A Dashboard views one Thing: a Dashboard summarizes one scope, such as a Studio, a Startup, a Team, or a Role.
views, inversedashboards.
Verbs
createCreates a Dashboard.POST /{namespace}/dashboardsgetReturns one Dashboard by id.GET /{namespace}/dashboards/{id}listReturns Dashboards, newest first, one page at a time.GET /{namespace}/dashboardsupdateChanges the given properties of a Dashboard.PATCH /{namespace}/dashboards/{id}deleteDeletes a Dashboard; its history is kept.DELETE /{namespace}/dashboards/{id}askAsk answers a plain-language question with a query over the Startup’s records and shows the query beside the result.POST /{namespace}/dashboards/askscheduleSchedule sends a Dashboard on a cadence to a Mailbox, a Channel or an Agent’s context, rendered for each.POST /{namespace}/dashboards/{dashboard}/schedule
Permissions
Which Access level may call each Verb. One-way Verbs wait their delay window.
| Operation | owner | admin | member | viewer |
|---|---|---|---|---|
Dashboard.create | Yes | Yes | Yes | No |
Dashboard.get | Yes | Yes | Yes | Yes |
Dashboard.list | Yes | Yes | Yes | Yes |
Dashboard.update | Yes | Yes | Yes | No |
Dashboard.delete | Yes | Yes | Yes | No |
Dashboard.ask | Yes | Yes | Yes | No |
Dashboard.schedule | Yes | Yes | Yes | No |
Call it
Ask my dashboard.Example
The Founder Dashboard of a tutoring marketplace shows bookings, open tutor hours, and runway. An Agent reads it as Markdown in its context, and the founder reads the same view on a phone.