changedInput schema / properties / widgets / items / oneOf
Previous value: -[
- {
- "additionalProperties": false,
- "description": "Text block widget (notes, headings, commentary). No queries or period — does not inherit dashboard metric/groupBy.",
- "properties": {
- "description": {
- "default": "",
- "type": "string"
- },
- "h": {
- "description": "Grid height in rows. When provided, the widget keeps this exact height instead of the auto-computed default. Obtain the value from the `h` field returned by `get`.",
- "exclusiveMinimum": 0,
- "maximum": 9007199254740991,
- "type": "integer"
- },
- "textContent": {
- "description": "Markdown or plain text body. Stored as `{ type: \"text\", textContent }` — same as the UI text widget.",
- "type": "string"
- },
- "title": {
- "type": "string"
- },
- "type": {
- "const": "text",
- "type": "string"
- },
- "w": {
- "description": "Grid width in columns (1–12). When provided, the widget keeps this exact width instead of the auto-computed default. Obtain the value from the `w` field returned by `get`.",
- "exclusiveMinimum": 0,
- "maximum": 12,
- "type": "integer"
- },
- "x": {
- "description": "Grid column index (0-based, 0 = left edge, max 11). When provided together with `y` (on a create_dashboard widget or an update_dashboard `add`) the widget is placed at the exact position instead of being auto-packed. Use `x`/`y` from `get` to copy a widget at its original position, or set manually (e.g. top-left: x=0 y=0, top-right of a half-width widget: x=6 y=0). Both `x` and `y` must be supplied together — if only one is given the position falls back to auto-packing. When `w` is also set, `x + w` must be <= 12.",
- "maximum": 11,
- "minimum": 0,
- "type": "integer"
- },
- "y": {
- "description": "Grid row index (0-based, 0 = top). Rows grow downward; combine with `x` to pin a widget to a specific spot. Both `x` and `y` must be supplied together — if only one is given the position falls back to auto-packing.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "type",
- "textContent",
- "title"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "aggBy": {
- "default": "Month",
- "description": "Time grain for the series: Hour, Day, Week, Month, or Period (default Month).",
- "enum": [
- "Hour",
- "Day",
- "Week",
- "Month",
- "Period"
- ],
- "type": "string"
- },
- "compare": {
- "additionalProperties": false,
- "description": "Add a comparison period to show cost evolution side-by-side. Omit `from`/`to` to compare against the preceding period automatically; set `chartType` to choose how it renders.",
- "properties": {
- "chartType": {
- "default": "WATERFALL",
- "description": "How the comparison renders: WATERFALL (default, contribution to change), TABLE (before/after rows), or KPI_BREAKDOWN (per-group KPI cards). Note KPI_BREAKDOWN and TABLE widgets cannot be exported as PNG via get_widget_png.",
- "enum": [
- "WATERFALL",
- "TABLE",
- "KPI_BREAKDOWN"
- ],
- "type": "string"
- },
- "enabled": {
- "default": true,
- "description": "Defaults to true — supplying `compare` at all turns the comparison on. Pass false to keep the block while disabling it (useful when echoing back a payload from `get`).",
- "type": "boolean"
- },
- "from": {
- "description": "Comparison period start date. Omit (together with `to`) to compare against the preceding period, derived from the main period.",
- "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
- "type": "string"
- },
- "to": {
- "description": "Comparison period end date. Required together with `from`; omit both to auto-derive.",
- "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
- "type": "string"
- }
- },
- "type": "object"
- },
- "datePreset": {
- "anyOf": [
- {
- "enum": [
- "TRAILING_90_DAYS",
- "TRAILING_30_DAYS",
- "TRAILING_45_DAYS",
- "TRAILING_7_DAYS",
- "TRAILING_3_DAYS",
- "TRAILING_1_DAYS",
- "TRAILING_14_WEEKS",
- "MTD",
- "QTD",
- "YTD",
- "CURRENT_MONTH",
- "CURRENT_QUARTER",
- "CURRENT_YEAR",
- "LAST_WEEK",
- "LAST_MONTH",
- "LAST_6_MONTHS",
- "LAST_12_MONTHS",
- "LAST_4_YEARS",
- "LAST_3_MONTHS",
- "LAST_INVOICE_MONTH"
- ],
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "description": "Widget-level date preset override. Omit to inherit dashboardContext.datePreset or startDate/endDate; use only when this widget differs from the dashboard period."
- },
- "description": {
- "default": "",
- "type": "string"
- },
- "displayOptions": {
- "description": "TABLE-only. sort {by, direction}, hideEmptyRows, topN (omit limit), showTotal, precision, pivot {rows, columns}. get_skill dashboards.",
- "properties": {
- "hideEmptyRows": {
- "description": "Hide rows with abs displayed sum < 0.01",
- "type": "boolean"
- },
- "pivot": {
- "additionalProperties": false,
- "description": "TABLE-only. Place groupBy, query, time on rows/columns. Outer first. get_skill dashboards.",
- "properties": {
- "columns": {
- "description": "Non-empty. Outer first. Same axes as rows.",
- "items": {
- "enum": [
- "groupBy",
- "query",
- "time"
- ],
- "type": "string"
- },
- "minItems": 1,
- "type": "array"
- },
- "rows": {
- "description": "Non-empty. Outer first. Each of groupBy, query, time at most once across rows+columns.",
- "items": {
- "enum": [
- "groupBy",
- "query",
- "time"
- ],
- "type": "string"
- },
- "minItems": 1,
- "type": "array"
- }
- },
- "required": [
- "rows",
- "columns"
- ],
- "type": "object"
- },
- "precision": {
- "description": "Fraction digits 0–6",
- "maximum": 6,
- "minimum": 0,
- "type": "integer"
- },
- "showTotal": {
- "description": "Show Total column",
- "type": "boolean"
- },
- "sort": {
- "properties": {
- "by": {
- "description": "total | cost | groupBy | query letter (a)",
- "minLength": 1,
- "type": "string"
- },
- "direction": {
- "default": "DESC",
- "description": "ASC | DESC (default DESC)",
- "enum": [
- "ASC",
- "DESC"
- ],
- "type": "string"
- }
- },
- "required": [
- "by"
- ],
- "type": "object"
- },
- "topN": {
- "description": "Ranked rows 1–100 after hide-empty + sort. Omit limit.",
- "maximum": 100,
- "minimum": 1,
- "type": "integer"
- }
- },
- "type": "object"
- },
- "extendDashboardConditions": {
- "default": true,
- "description": "Whether this widget AND-merges the dashboard's `context.conditionsCel` into cost and usage series `filterCel`. Defaults to true — omit to inherit the dashboard filter. Set false only when the widget must ignore dashboard-wide conditions.",
- "type": "boolean"
- },
- "from": {
- "description": "Widget-level date override (inclusive), e.g. '2025-01-01'. Omit when the widget uses the dashboard context period.",
- "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
- "type": "string"
- },
- "h": {
- "description": "Grid height in rows. When provided, the widget keeps this exact height instead of the auto-computed default. Obtain the value from the `h` field returned by `get`.",
- "exclusiveMinimum": 0,
- "maximum": 9007199254740991,
- "type": "integer"
- },
- "limit": {
- "description": "Max groups/rows per series. Omit to use the default (100). Increase up to 1000 when you need more than 100 breakdown groups. On a non-comparison TABLE, use displayOptions.topN for the row cap and omit this — the two are mutually exclusive there.",
- "maximum": 1000,
- "minimum": 1,
- "type": "integer"
- },
- "queries": {
- "description": "Same series objects as the `query` tool `queries` array (cost / metric / usage / externalMetric / formula / budget). Each requires `type` (never omit) and a `name` (prefer short ids like a/b/c); put human labels in `alias`. Cost may omit metricId, currency, and groupBy to inherit dashboardContext. Usage requires metricId (a usage id, not a cost column) and has no currency; omit groupBy to inherit. Cost and usage inherit conditionsCel unless extendDashboardConditions is false. `visible: false` hides a series. Call get_skill skillId: \"dashboards\" for examples.",
- "items": {
- "additionalProperties": {},
- "propertyNames": {
- "type": "string"
- },
- "type": "object"
- },
- "type": "array"
- },
- "scopeId": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "description": "Optional saved team scope id (from list_teams). Merges the scope whereClause into cost/usage queries."
- },
- "title": {
- "type": "string"
- },
- "to": {
- "description": "Widget-level end date override (inclusive). Required together with `from` only when overriding the dashboard period; omit when inheriting context.",
- "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
- "type": "string"
- },
- "type": {
- "const": "chart",
- "default": "chart",
- "type": "string"
- },
- "w": {
- "description": "Grid width in columns (1–12). When provided, the widget keeps this exact width instead of the auto-computed default. Obtain the value from the `w` field returned by `get`.",
- "exclusiveMinimum": 0,
- "maximum": 12,
- "type": "integer"
- },
- "x": {
- "description": "Grid column index (0-based, 0 = left edge, max 11). When provided together with `y` (on a create_dashboard widget or an update_dashboard `add`) the widget is placed at the exact position instead of being auto-packed. Use `x`/`y` from `get` to copy a widget at its original position, or set manually (e.g. top-left: x=0 y=0, top-right of a half-width widget: x=6 y=0). Both `x` and `y` must be supplied together — if only one is given the position falls back to auto-packing. When `w` is also set, `x + w` must be <= 12.",
- "maximum": 11,
- "minimum": 0,
- "type": "integer"
- },
- "y": {
- "description": "Grid row index (0-based, 0 = top). Rows grow downward; combine with `x` to pin a widget to a specific spot. Both `x` and `y` must be supplied together — if only one is given the position falls back to auto-packing.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "title"
- ],
- "type": "object"
- }
-]New value: +[
+ {
+ "additionalProperties": false,
+ "description": "Text block widget (notes, headings, commentary). No queries or period — does not inherit dashboard metric/groupBy.",
+ "properties": {
+ "description": {
+ "default": "",
+ "type": "string"
+ },
+ "h": {
+ "description": "Grid height in rows. When provided, the widget keeps this exact height instead of the auto-computed default. Obtain the value from the `h` field returned by `get`.",
+ "exclusiveMinimum": 0,
+ "maximum": 9007199254740991,
+ "type": "integer"
+ },
+ "textContent": {
+ "description": "Markdown or plain text body. Stored as `{ type: \"text\", textContent }` — same as the UI text widget.",
+ "type": "string"
+ },
+ "title": {
+ "type": "string"
+ },
+ "type": {
+ "const": "text",
+ "type": "string"
+ },
+ "w": {
+ "description": "Grid width in columns (1–12). When provided, the widget keeps this exact width instead of the auto-computed default. Obtain the value from the `w` field returned by `get`.",
+ "exclusiveMinimum": 0,
+ "maximum": 12,
+ "type": "integer"
+ },
+ "x": {
+ "description": "Grid column index (0-based, 0 = left edge, max 11). When provided together with `y` (on a create_dashboard widget or an update_dashboard `add`) the widget is placed at the exact position instead of being auto-packed. Use `x`/`y` from `get` to copy a widget at its original position, or set manually (e.g. top-left: x=0 y=0, top-right of a half-width widget: x=6 y=0). Both `x` and `y` must be supplied together — if only one is given the position falls back to auto-packing. When `w` is also set, `x + w` must be <= 12.",
+ "maximum": 11,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "y": {
+ "description": "Grid row index (0-based, 0 = top). Rows grow downward; combine with `x` to pin a widget to a specific spot. Both `x` and `y` must be supplied together — if only one is given the position falls back to auto-packing.",
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "type",
+ "textContent",
+ "title"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "aggBy": {
+ "default": "Month",
+ "description": "Time grain for the series: Hour, Day, Week, Month, or Period (default Month).",
+ "enum": [
+ "Hour",
+ "Day",
+ "Week",
+ "Month",
+ "Period"
+ ],
+ "type": "string"
+ },
+ "compare": {
+ "additionalProperties": false,
+ "description": "Add a comparison period to show cost evolution side-by-side. Omit `from`/`to` to compare against the preceding period automatically; set `chartType` to choose how it renders.",
+ "properties": {
+ "chartType": {
+ "default": "WATERFALL",
+ "description": "How the comparison renders: WATERFALL (default, contribution to change), TABLE (before/after rows), or KPI_BREAKDOWN (per-group KPI cards). Note KPI_BREAKDOWN and TABLE widgets cannot be exported as PNG via get_widget_png.",
+ "enum": [
+ "WATERFALL",
+ "TABLE",
+ "KPI_BREAKDOWN"
+ ],
+ "type": "string"
+ },
+ "enabled": {
+ "default": true,
+ "description": "Defaults to true — supplying `compare` at all turns the comparison on. Pass false to keep the block while disabling it (useful when echoing back a payload from `get`).",
+ "type": "boolean"
+ },
+ "from": {
+ "description": "Comparison period start date. Omit (together with `to`) to compare against the preceding period, derived from the main period.",
+ "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+ "type": "string"
+ },
+ "to": {
+ "description": "Comparison period end date. Required together with `from`; omit both to auto-derive.",
+ "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "datePreset": {
+ "anyOf": [
+ {
+ "enum": [
+ "TRAILING_90_DAYS",
+ "TRAILING_30_DAYS",
+ "TRAILING_45_DAYS",
+ "TRAILING_7_DAYS",
+ "TRAILING_3_DAYS",
+ "TRAILING_1_DAYS",
+ "TRAILING_14_WEEKS",
+ "MTD",
+ "QTD",
+ "YTD",
+ "CURRENT_MONTH",
+ "CURRENT_QUARTER",
+ "CURRENT_YEAR",
+ "LAST_WEEK",
+ "LAST_MONTH",
+ "LAST_6_MONTHS",
+ "LAST_12_MONTHS",
+ "LAST_4_YEARS",
+ "LAST_3_MONTHS",
+ "LAST_INVOICE_MONTH"
+ ],
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Widget-level date preset override. Omit to inherit dashboardContext.datePreset or startDate/endDate; use only when this widget differs from the dashboard period."
+ },
+ "description": {
+ "default": "",
+ "type": "string"
+ },
+ "displayOptions": {
+ "description": "TABLE-only. sort {by, direction}, hideEmptyRows, topN (omit limit), showTotal, precision, pivot {rows, columns}. get_skill dashboards.",
+ "properties": {
+ "hideEmptyRows": {
+ "description": "Hide rows with abs displayed sum < 0.01",
+ "type": "boolean"
+ },
+ "pivot": {
+ "additionalProperties": false,
+ "description": "TABLE-only. Place groupBy, query, time on rows/columns. Outer first. get_skill dashboards.",
+ "properties": {
+ "columns": {
+ "description": "Non-empty. Outer first. Same axes as rows.",
+ "items": {
+ "enum": [
+ "groupBy",
+ "query",
+ "time"
+ ],
+ "type": "string"
+ },
+ "minItems": 1,
+ "type": "array"
+ },
+ "rows": {
+ "description": "Non-empty. Outer first. Each of groupBy, query, time at most once across rows+columns.",
+ "items": {
+ "enum": [
+ "groupBy",
+ "query",
+ "time"
+ ],
+ "type": "string"
+ },
+ "minItems": 1,
+ "type": "array"
+ }
+ },
+ "required": [
+ "rows",
+ "columns"
+ ],
+ "type": "object"
+ },
+ "precision": {
+ "description": "Fraction digits 0–6",
+ "maximum": 6,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "showTotal": {
+ "description": "Show Total column",
+ "type": "boolean"
+ },
+ "sort": {
+ "properties": {
+ "by": {
+ "description": "total | cost | groupBy | query letter (a)",
+ "minLength": 1,
+ "type": "string"
+ },
+ "direction": {
+ "default": "DESC",
+ "description": "ASC | DESC (default DESC)",
+ "enum": [
+ "ASC",
+ "DESC"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "by"
+ ],
+ "type": "object"
+ },
+ "topN": {
+ "description": "Ranked rows 1–100 after hide-empty + sort. Omit limit.",
+ "maximum": 100,
+ "minimum": 1,
+ "type": "integer"
+ }
+ },
+ "type": "object"
+ },
+ "extendDashboardConditions": {
+ "default": true,
+ "description": "Whether this widget AND-merges the dashboard's `context.conditionsCel` into cost and usage series `filterCel`. Defaults to true — omit to inherit the dashboard filter. Set false only when the widget must ignore dashboard-wide conditions.",
+ "type": "boolean"
+ },
+ "from": {
+ "description": "Widget-level date override (inclusive), e.g. '2025-01-01'. Omit when the widget uses the dashboard context period.",
+ "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+ "type": "string"
+ },
+ "h": {
+ "description": "Grid height in rows. When provided, the widget keeps this exact height instead of the auto-computed default. Obtain the value from the `h` field returned by `get`.",
+ "exclusiveMinimum": 0,
+ "maximum": 9007199254740991,
+ "type": "integer"
+ },
+ "limit": {
+ "description": "Max groups/rows per series. Omit to use the default (100). Increase up to 1000 when you need more than 100 breakdown groups. On a non-comparison TABLE, use displayOptions.topN for the row cap and omit this — the two are mutually exclusive there.",
+ "maximum": 1000,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "queries": {
+ "description": "Same series objects as the `query` tool `queries` array (cost / metric / usage / externalMetric / formula / budget). Each requires `type` (never omit) and a `name` (prefer short ids like a/b/c); put human labels in `alias`. Cost may omit metricId, currency, and groupBy to inherit dashboardContext. Usage requires metricId (a usage id, not a cost column) and has no currency; omit groupBy to inherit. Budget groupBy is explicit (the budget virtual dimension bqName from get); it does not inherit dashboardContext.groupBy — omit for the total. Cost and usage inherit conditionsCel unless extendDashboardConditions is false. `visible: false` hides a series. Call get_skill skillId: \"dashboards\" for examples.",
+ "items": {
+ "additionalProperties": {},
+ "propertyNames": {
+ "type": "string"
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "scopeId": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Optional saved team scope id (from list_teams). Merges the scope whereClause into cost/usage queries."
+ },
+ "title": {
+ "type": "string"
+ },
+ "to": {
+ "description": "Widget-level end date override (inclusive). Required together with `from` only when overriding the dashboard period; omit when inheriting context.",
+ "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+ "type": "string"
+ },
+ "type": {
+ "const": "chart",
+ "default": "chart",
+ "type": "string"
+ },
+ "w": {
+ "description": "Grid width in columns (1–12). When provided, the widget keeps this exact width instead of the auto-computed default. Obtain the value from the `w` field returned by `get`.",
+ "exclusiveMinimum": 0,
+ "maximum": 12,
+ "type": "integer"
+ },
+ "x": {
+ "description": "Grid column index (0-based, 0 = left edge, max 11). When provided together with `y` (on a create_dashboard widget or an update_dashboard `add`) the widget is placed at the exact position instead of being auto-packed. Use `x`/`y` from `get` to copy a widget at its original position, or set manually (e.g. top-left: x=0 y=0, top-right of a half-width widget: x=6 y=0). Both `x` and `y` must be supplied together — if only one is given the position falls back to auto-packing. When `w` is also set, `x + w` must be <= 12.",
+ "maximum": 11,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "y": {
+ "description": "Grid row index (0-based, 0 = top). Rows grow downward; combine with `x` to pin a widget to a specific spot. Both `x` and `y` must be supplied together — if only one is given the position falls back to auto-packing.",
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "title"
+ ],
+ "type": "object"
+ }
+]