Dashboard commands: ask, schedule
The Dashboard Verbs ask, schedule as CLI commands, with inputs, result, refusals and an example.
Reference for Dashboard, one group of Dashboard commands.
Dashboard.ask
Ask answers a plain-language question with a query over the Startup’s records and shows the query beside the result. Verb page.
npx startup-builder do Dashboard.ask --json '<input>' [--try | --send | --do]Emits Dashboard.asked.
Inputs
| Input | Type | Required | Description |
|---|---|---|---|
question | text | required | The question, in plain language. |
dashboard | Dashboard | The Dashboard to add the answer to as a tile. |
Returns
| Output | Type | Required | Description |
|---|---|---|---|
query | text | required | The query it ran, to read and reuse. |
rows | json | required | The result, as a table or chart. |
dashboard | Dashboard | required | The Dashboard the question was asked on. |
Refuses when
| Check | Error | Fix | Then call |
|---|---|---|---|
| The key is valid, but its scopes do not allow this operation. | forbidden | Use a key whose scopes cover the operation, or ask an owner of the namespace to grant them. | None. |
Example
npx startup-builder do Dashboard.ask --json '{"question":Dashboard.schedule
Schedule sends a Dashboard on a cadence to a Mailbox, a Channel or an Agent’s context, rendered for each. Verb page.
npx startup-builder do Dashboard.schedule --json '<input>' [--try | --send | --do]Emits Dashboard.scheduled.
Inputs
| Input | Type | Required | Description |
|---|---|---|---|
dashboard | Dashboard | required | The Dashboard to send. |
cadence | string | required | How often it goes out. |
to | string | required | The Mailbox, Channel or Agent that receives it. |
Returns
| Output | Type | Required | Description |
|---|---|---|---|
dashboard | Dashboard | required | The Dashboard, with its schedule. |
Refuses when
| Check | Error | Fix | Then call |
|---|---|---|---|
| The key is valid, but its scopes do not allow this operation. | forbidden | Use a key whose scopes cover the operation, or ask an owner of the namespace to grant them. | None. |
Example
npx startup-builder do Dashboard.schedule --json '{"dashboard":