Capable

Run report

run_report

Read-only

Preview analysis/dashboard data for your own reading; shows the user nothing. To display it, call show_report. Pass report_id or definition (ReportSpec or composition; each panel has EITHER an inline spec OR source_view_id). Use ref objects, e.g. {kind:"related",path:"account.name"}. in_period uses only its closed set; fixed ranges use gte + lt/lte. Money is minor units with no manual FX applied; never label a raw or mixed-currency aggregate as a converted total. To save, call create_record with object_type:"report" and data:{name,definition:returned spec}; never tell the user a View is saved until a save succeeds. Say when zero rows match; fix returned definition errors. Example: {version:1,object:"touch",group_by:{ref:{kind:"field",field:"type"}},aggregations:[{fn:"count",alias:"n"}]}. Recipes: capable://guide/reports.

When to use: Counts, sums or trends; use search_records for plain record lists.

Example: Analyze ARR by industry.

Input Schema

Name	Required	Description
`report_id`	No	A saved analysis or dashboard's id (uuid), run with its stored definition; give this or definition — report_id wins when both are passed.
`definition`	No	An inline ReportSpec (object, columns, filters, group_by, aggregations, viz) or a composition (dashboard) to preview; omit when passing report_id.
`source_view_id`	No	Id (uuid) of the saved View this inline definition refines, so a save updates it in place instead of creating a twin; ignored with report_id.
`suggested_name`	No	A name for a later save, echoed as suggested_name; only meaningful with an inline definition (this call saves nothing).

Output Schema

Name	Required	Description	Default
`viz`	No
`kind`	No
`mode`	No
`note`	No
`rows`	No
`spec`	No
`empty`	No
`title`	No
`deltas`	No
`layout`	No
`object`	No
`period`	No
`columns`	No
`widgets`	No
`group_ref`	No
`row_count`	No
`truncated`	No
`board_group`	No
`aggregations`	No
`group_bucket`	No
`source_view_id`	No
`suggested_name`	No
`group_ref_secondary`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 24, 2026

changedInput schema / properties / definition / anyOf

Previous value: -[
-  {
-    "properties": {
-      "dashboard_filters": {
-        "properties": {
-          "filters": {
-            "items": {
-              "properties": {
-                "object": {
-                  "maxLength": 100,
-                  "minLength": 1,
-                  "type": "string"
-                },
-                "op": {
-                  "enum": [
-                    "eq",
-                    "gte",
-                    "lte",
-                    "in_period"
-                  ],
-                  "type": "string"
-                },
-                "ref": {
-                  "description": "Same shape as a `columns` item of the ReportSpec variant (a column reference: kind field | custom | related).",
-                  "type": "object"
-                },
-                "value": {
-                  "maxLength": 1000,
-                  "minLength": 1,
-                  "type": "string"
-                }
-              },
-              "required": [
-                "ref",
-                "value"
-              ],
-              "type": "object"
-            },
-            "maxItems": 6,
-            "type": "array"
-          },
-          "period": {
-            "properties": {
-              "default": {
-                "enum": [
-                  "today",
-                  "yesterday",
-                  "this_week",
-                  "last_7_days",
-                  "next_7_days",
-                  "last_30_days",
-                  "next_30_days",
-                  "last_90_days",
-                  "this_month",
-                  "last_month",
-                  "this_quarter",
-                  "this_year",
-                  "overdue",
-                  "upcoming"
-                ],
-                "type": "string"
-              },
-              "enabled": {
-                "const": true,
-                "type": "boolean"
-              }
-            },
-            "required": [
-              "enabled"
-            ],
-            "type": "object"
-          }
-        },
-        "type": "object"
-      },
-      "kind": {
-        "const": "composition",
-        "type": "string"
-      },
-      "layout": {
-        "properties": {
-          "rows": {
-            "items": {
-              "properties": {
-                "widgetIds": {
-                  "items": {
-                    "minLength": 1,
-                    "type": "string"
-                  },
-                  "minItems": 1,
-                  "type": "array"
-                }
-              },
-              "required": [
-                "widgetIds"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          }
-        },
-        "required": [
-          "rows"
-        ],
-        "type": "object"
-      },
-      "title": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "version": {
-        "const": 1,
-        "type": "number"
-      },
-      "widgets": {
-        "items": {
-          "properties": {
-            "id": {
-              "minLength": 1,
-              "type": "string"
-            },
-            "pin_window": {
-              "type": "boolean"
-            },
-            "source_view_id": {
-              "minLength": 1,
-              "type": "string"
-            },
-            "spec": {
-              "description": "Inline ReportSpec for this panel — the same shape as the ReportSpec variant of this definition."
-            },
-            "title": {
-              "minLength": 1,
-              "type": "string"
-            },
-            "viz": {
-              "enum": [
-                "table",
-                "bar",
-                "stat",
-                "trend",
-                "donut",
-                "board",
-                "matrix",
-                "funnel",
-                "column",
-                "area"
-              ],
-              "type": "string"
-            },
-            "width": {
-              "anyOf": [
-                {
-                  "const": 2,
-                  "type": "number"
-                },
-                {
-                  "const": 3,
-                  "type": "number"
-                },
-                {
-                  "const": 4,
-                  "type": "number"
-                },
-                {
-                  "const": 6,
-                  "type": "number"
-                }
-              ]
-            }
-          },
-          "required": [
-            "id",
-            "title"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      }
-    },
-    "required": [
-      "version",
-      "kind",
-      "layout",
-      "widgets"
-    ],
-    "type": "object"
-  },
-  {
-    "properties": {
-      "kind": {
-        "const": "segment",
-        "type": "string"
-      },
-      "object": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "state": {
-        "properties": {
-          "conds": {
-            "items": {
-              "properties": {
-                "fieldKey": {
-                  "maxLength": 80,
-                  "minLength": 1,
-                  "type": "string"
-                },
-                "op": {
-                  "enum": [
-                    "contains",
-                    "eq",
-                    "is_null",
-                    "gte",
-                    "lt",
-                    "between",
-                    "in_next",
-                    "in_last",
-                    "overdue",
-                    "in",
-                    "not_in"
-                  ],
-                  "type": "string"
-                },
-                "value": {
-                  "anyOf": [
-                    {
-                      "maxLength": 120,
-                      "type": "string"
-                    },
-                    {
-                      "items": {
-                        "maxLength": 120,
-                        "minLength": 1,
-                        "type": "string"
-                      },
-                      "maxItems": 50,
-                      "minItems": 1,
-                      "type": "array"
-                    }
-                  ]
-                }
-              },
-              "required": [
-                "fieldKey",
-                "op"
-              ],
-              "type": "object"
-            },
-            "maxItems": 8,
-            "type": "array"
-          },
-          "filters": {
-            "additionalProperties": {
-              "maxLength": 120,
-              "minLength": 1,
-              "type": "string"
-            },
-            "propertyNames": {
-              "maxLength": 80,
-              "minLength": 1,
-              "type": "string"
-            },
-            "type": "object"
-          },
-          "match": {
-            "enum": [
-              "all",
-              "any"
-            ],
-            "type": "string"
-          },
-          "q": {
-            "maxLength": 200,
-            "minLength": 1,
-            "type": "string"
-          },
-          "seg": {
-            "maxLength": 64,
-            "minLength": 1,
-            "type": "string"
-          },
-          "sort": {
-            "maxLength": 64,
-            "minLength": 1,
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "version": {
-        "const": 1,
-        "type": "number"
-      }
-    },
-    "required": [
-      "version",
-      "kind",
-      "object",
-      "state"
-    ],
-    "type": "object"
-  },
-  {
-    "properties": {
-      "aggregations": {
-        "default": [],
-        "items": {
-          "properties": {
-            "alias": {
-              "minLength": 1,
-              "type": "string"
-            },
-            "fn": {
-              "enum": [
-                "count",
-                "count_distinct",
-                "sum",
-                "avg",
-                "min",
-                "max"
-              ],
-              "type": "string"
-            },
-            "ref": {
-              "description": "Same shape as a `columns` item of the ReportSpec variant (a column reference: kind field | custom | related).",
-              "type": "object"
-            },
-            "where": {
-              "items": {
-                "description": "Same shape as a `filters` item (field or custom refs with absolute operators).",
-                "type": "object"
-              },
-              "maxItems": 3,
-              "type": "array"
-            }
-          },
-          "required": [
-            "fn",
-            "alias"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "board_group": {
-        "description": "Same shape as a `columns` item of the ReportSpec variant (a column reference: kind field | custom | related).",
-        "type": "object"
-      },
-      "columns": {
-        "default": [],
-        "items": {
-          "oneOf": [
-            {
-              "properties": {
-                "field": {
-                  "minLength": 1,
-                  "type": "string"
-                },
-                "kind": {
-                  "const": "field",
-                  "type": "string"
-                }
-              },
-              "required": [
-                "kind",
-                "field"
-              ],
-              "type": "object"
-            },
-            {
-              "properties": {
-                "key": {
-                  "minLength": 1,
-                  "type": "string"
-                },
-                "kind": {
-                  "const": "custom",
-                  "type": "string"
-                }
-              },
-              "required": [
-                "kind",
-                "key"
-              ],
-              "type": "object"
-            },
-            {
-              "properties": {
-                "kind": {
-                  "const": "related",
-                  "type": "string"
-                },
-                "path": {
-                  "minLength": 1,
-                  "type": "string"
-                }
-              },
-              "required": [
-                "kind",
-                "path"
-              ],
-              "type": "object"
-            }
-          ]
-        },
-        "type": "array"
-      },
-      "compare": {
-        "enum": [
-          "previous_period"
-        ],
-        "type": "string"
-      },
-      "derived": {
-        "items": {
-          "properties": {
-            "alias": {
-              "minLength": 1,
-              "type": "string"
-            },
-            "denominator": {
-              "minLength": 1,
-              "type": "string"
-            },
-            "format": {
-              "enum": [
-                "percent",
-                "number"
-              ],
-              "type": "string"
-            },
-            "kind": {
-              "const": "ratio",
-              "type": "string"
-            },
-            "numerator": {
-              "minLength": 1,
-              "type": "string"
-            }
-          },
-          "required": [
-            "kind",
-            "numerator",
-            "denominator",
-            "alias"
-          ],
-          "type": "object"
-        },
-        "maxItems": 3,
-        "type": "array"
-      },
-      "filter_groups": {
-        "items": {
-          "properties": {
-            "filters": {
-              "items": {
-                "description": "Same shape as a `filters` item.",
-                "type": "object"
-              },
-              "maxItems": 6,
-              "minItems": 1,
-              "type": "array"
-            },
-            "mode": {
-              "enum": [
-                "any",
-                "none"
-              ],
-              "type": "string"
-            }
-          },
-          "required": [
-            "mode",
-            "filters"
-          ],
-          "type": "object"
-        },
-        "maxItems": 4,
-        "type": "array"
-      },
-      "filters": {
-        "default": [],
-        "items": {
-          "properties": {
-            "op": {
-              "enum": [
-                "eq",
-                "neq",
-                "gt",
-                "gte",
-                "lt",
-                "lte",
-                "contains",
-                "starts_with",
-                "in",
-                "not_in",
-                "has_any",
-                "in_period",
-                "is_null",
-                "is_not_null"
-              ],
-              "type": "string"
-            },
-            "ref": {
-              "description": "Same shape as a `columns` item of the ReportSpec variant (a column reference: kind field | custom | related).",
-              "type": "object"
-            },
-            "value": {}
-          },
-          "required": [
-            "ref",
-            "op"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "group_by": {
-        "anyOf": [
-          {
-            "properties": {
-              "bucket": {
-                "enum": [
-                  "day",
-                  "week",
-                  "month",
-                  "quarter",
-                  "year"
-                ],
-                "type": "string"
-              },
-              "ref": {
-                "description": "Same shape as a `columns` item of the ReportSpec variant (a column reference: kind field | custom | related).",
-                "type": "object"
-              }
-            },
-            "required": [
-              "ref"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "group_by_secondary": {
-        "anyOf": [
-          {
-            "description": "Same shape as `group_by`.",
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "limit": {
-        "default": 1000,
-        "exclusiveMinimum": 0,
-        "maximum": 9007199254740991,
-        "type": "integer"
-      },
-      "object": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "related_filters": {
-        "items": {
-          "properties": {
-            "filters": {
-              "default": [],
-              "items": {
-                "description": "Same shape as a `filters` item.",
-                "type": "object"
-              },
-              "maxItems": 5,
-              "type": "array"
-            },
-            "mode": {
-              "enum": [
-                "with",
-                "without"
-              ],
-              "type": "string"
-            },
-            "related": {
-              "minLength": 1,
-              "type": "string"
-            }
-          },
-          "required": [
-            "related",
-            "mode"
-          ],
-          "type": "object"
-        },
-        "maxItems": 3,
-        "type": "array"
-      },
-      "show_share": {
-        "type": "boolean"
-      },
-      "sort": {
-        "anyOf": [
-          {
-            "properties": {
-              "dir": {
-                "enum": [
-                  "asc",
-                  "desc"
-                ],
-                "type": "string"
-              },
-              "ref": {
-                "minLength": 1,
-                "type": "string"
-              }
-            },
-            "required": [
-              "ref",
-              "dir"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "version": {
-        "const": 1,
-        "type": "number"
-      },
-      "viz": {
-        "enum": [
-          "table",
-          "bar",
-          "stat",
-          "trend",
-          "donut",
-          "board",
-          "matrix",
-          "funnel",
-          "column",
-          "area"
-        ],
-        "type": "string"
-      }
-    },
-    "required": [
-      "version",
-      "object"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "properties": {
+      "dashboard_filters": {
+        "properties": {
+          "filters": {
+            "items": {
+              "properties": {
+                "object": {
+                  "maxLength": 100,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "op": {
+                  "enum": [
+                    "eq",
+                    "gte",
+                    "lte",
+                    "in_period"
+                  ],
+                  "type": "string"
+                },
+                "ref": {
+                  "description": "Same shape as a `columns` item of the ReportSpec variant (a column reference: kind field | custom | related).",
+                  "type": "object"
+                },
+                "value": {
+                  "maxLength": 1000,
+                  "minLength": 1,
+                  "type": "string"
+                }
+              },
+              "required": [
+                "ref",
+                "value"
+              ],
+              "type": "object"
+            },
+            "maxItems": 6,
+            "type": "array"
+          },
+          "period": {
+            "properties": {
+              "default": {
+                "enum": [
+                  "today",
+                  "yesterday",
+                  "this_week",
+                  "last_7_days",
+                  "next_7_days",
+                  "last_30_days",
+                  "next_30_days",
+                  "last_90_days",
+                  "this_month",
+                  "last_month",
+                  "this_quarter",
+                  "this_year",
+                  "overdue",
+                  "upcoming",
+                  "tomorrow",
+                  "next_working_day",
+                  "next_5_working_days"
+                ],
+                "type": "string"
+              },
+              "enabled": {
+                "const": true,
+                "type": "boolean"
+              }
+            },
+            "required": [
+              "enabled"
+            ],
+            "type": "object"
+          }
+        },
+        "type": "object"
+      },
+      "kind": {
+        "const": "composition",
+        "type": "string"
+      },
+      "layout": {
+        "properties": {
+          "rows": {
+            "items": {
+              "properties": {
+                "widgetIds": {
+                  "items": {
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "minItems": 1,
+                  "type": "array"
+                }
+              },
+              "required": [
+                "widgetIds"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          }
+        },
+        "required": [
+          "rows"
+        ],
+        "type": "object"
+      },
+      "title": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "version": {
+        "const": 1,
+        "type": "number"
+      },
+      "widgets": {
+        "items": {
+          "properties": {
+            "id": {
+              "minLength": 1,
+              "type": "string"
+            },
+            "pin_window": {
+              "type": "boolean"
+            },
+            "source_view_id": {
+              "minLength": 1,
+              "type": "string"
+            },
+            "spec": {
+              "description": "Inline ReportSpec for this panel — the same shape as the ReportSpec variant of this definition."
+            },
+            "title": {
+              "minLength": 1,
+              "type": "string"
+            },
+            "viz": {
+              "enum": [
+                "table",
+                "bar",
+                "stat",
+                "trend",
+                "donut",
+                "board",
+                "matrix",
+                "funnel",
+                "column",
+                "area"
+              ],
+              "type": "string"
+            },
+            "width": {
+              "anyOf": [
+                {
+                  "const": 2,
+                  "type": "number"
+                },
+                {
+                  "const": 3,
+                  "type": "number"
+                },
+                {
+                  "const": 4,
+                  "type": "number"
+                },
+                {
+                  "const": 6,
+                  "type": "number"
+                }
+              ]
+            }
+          },
+          "required": [
+            "id",
+            "title"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "version",
+      "kind",
+      "layout",
+      "widgets"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "kind": {
+        "const": "segment",
+        "type": "string"
+      },
+      "object": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "state": {
+        "properties": {
+          "conds": {
+            "items": {
+              "properties": {
+                "fieldKey": {
+                  "maxLength": 80,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "op": {
+                  "enum": [
+                    "contains",
+                    "eq",
+                    "is_null",
+                    "gte",
+                    "lt",
+                    "between",
+                    "in_next",
+                    "in_last",
+                    "overdue",
+                    "in",
+                    "not_in"
+                  ],
+                  "type": "string"
+                },
+                "value": {
+                  "anyOf": [
+                    {
+                      "maxLength": 120,
+                      "type": "string"
+                    },
+                    {
+                      "items": {
+                        "maxLength": 120,
+                        "minLength": 1,
+                        "type": "string"
+                      },
+                      "maxItems": 50,
+                      "minItems": 1,
+                      "type": "array"
+                    }
+                  ]
+                }
+              },
+              "required": [
+                "fieldKey",
+                "op"
+              ],
+              "type": "object"
+            },
+            "maxItems": 8,
+            "type": "array"
+          },
+          "filters": {
+            "additionalProperties": {
+              "maxLength": 120,
+              "minLength": 1,
+              "type": "string"
+            },
+            "propertyNames": {
+              "maxLength": 80,
+              "minLength": 1,
+              "type": "string"
+            },
+            "type": "object"
+          },
+          "match": {
+            "enum": [
+              "all",
+              "any"
+            ],
+            "type": "string"
+          },
+          "q": {
+            "maxLength": 200,
+            "minLength": 1,
+            "type": "string"
+          },
+          "seg": {
+            "maxLength": 64,
+            "minLength": 1,
+            "type": "string"
+          },
+          "sort": {
+            "maxLength": 64,
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "version": {
+        "const": 1,
+        "type": "number"
+      }
+    },
+    "required": [
+      "version",
+      "kind",
+      "object",
+      "state"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "aggregations": {
+        "default": [],
+        "items": {
+          "properties": {
+            "alias": {
+              "minLength": 1,
+              "type": "string"
+            },
+            "fn": {
+              "enum": [
+                "count",
+                "count_distinct",
+                "sum",
+                "avg",
+                "min",
+                "max"
+              ],
+              "type": "string"
+            },
+            "ref": {
+              "description": "Same shape as a `columns` item of the ReportSpec variant (a column reference: kind field | custom | related).",
+              "type": "object"
+            },
+            "where": {
+              "items": {
+                "description": "Same shape as a `filters` item (field or custom refs with absolute operators).",
+                "type": "object"
+              },
+              "maxItems": 3,
+              "type": "array"
+            }
+          },
+          "required": [
+            "fn",
+            "alias"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "board_group": {
+        "description": "Same shape as a `columns` item of the ReportSpec variant (a column reference: kind field | custom | related).",
+        "type": "object"
+      },
+      "columns": {
+        "default": [],
+        "items": {
+          "oneOf": [
+            {
+              "properties": {
+                "field": {
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "kind": {
+                  "const": "field",
+                  "type": "string"
+                }
+              },
+              "required": [
+                "kind",
+                "field"
+              ],
+              "type": "object"
+            },
+            {
+              "properties": {
+                "key": {
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "kind": {
+                  "const": "custom",
+                  "type": "string"
+                }
+              },
+              "required": [
+                "kind",
+                "key"
+              ],
+              "type": "object"
+            },
+            {
+              "properties": {
+                "kind": {
+                  "const": "related",
+                  "type": "string"
+                },
+                "path": {
+                  "minLength": 1,
+                  "type": "string"
+                }
+              },
+              "required": [
+                "kind",
+                "path"
+              ],
+              "type": "object"
+            }
+          ]
+        },
+        "type": "array"
+      },
+      "compare": {
+        "enum": [
+          "previous_period"
+        ],
+        "type": "string"
+      },
+      "derived": {
+        "items": {
+          "properties": {
+            "alias": {
+              "minLength": 1,
+              "type": "string"
+            },
+            "denominator": {
+              "minLength": 1,
+              "type": "string"
+            },
+            "format": {
+              "enum": [
+                "percent",
+                "number"
+              ],
+              "type": "string"
+            },
+            "kind": {
+              "const": "ratio",
+              "type": "string"
+            },
+            "numerator": {
+              "minLength": 1,
+              "type": "string"
+            }
+          },
+          "required": [
+            "kind",
+            "numerator",
+            "denominator",
+            "alias"
+          ],
+          "type": "object"
+        },
+        "maxItems": 3,
+        "type": "array"
+      },
+      "filter_groups": {
+        "items": {
+          "properties": {
+            "filters": {
+              "items": {
+                "description": "Same shape as a `filters` item.",
+                "type": "object"
+              },
+              "maxItems": 6,
+              "minItems": 1,
+              "type": "array"
+            },
+            "mode": {
+              "enum": [
+                "any",
+                "none"
+              ],
+              "type": "string"
+            }
+          },
+          "required": [
+            "mode",
+            "filters"
+          ],
+          "type": "object"
+        },
+        "maxItems": 4,
+        "type": "array"
+      },
+      "filters": {
+        "default": [],
+        "items": {
+          "properties": {
+            "op": {
+              "enum": [
+                "eq",
+                "neq",
+                "gt",
+                "gte",
+                "lt",
+                "lte",
+                "contains",
+                "starts_with",
+                "in",
+                "not_in",
+                "has_any",
+                "in_period",
+                "is_null",
+                "is_not_null"
+              ],
+              "type": "string"
+            },
+            "ref": {
+              "description": "Same shape as a `columns` item of the ReportSpec variant (a column reference: kind field | custom | related).",
+              "type": "object"
+            },
+            "value": {}
+          },
+          "required": [
+            "ref",
+            "op"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "group_by": {
+        "anyOf": [
+          {
+            "properties": {
+              "bucket": {
+                "enum": [
+                  "day",
+                  "week",
+                  "month",
+                  "quarter",
+                  "year"
+                ],
+                "type": "string"
+              },
+              "ref": {
+                "description": "Same shape as a `columns` item of the ReportSpec variant (a column reference: kind field | custom | related).",
+                "type": "object"
+              }
+            },
+            "required": [
+              "ref"
+            ],
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "group_by_secondary": {
+        "anyOf": [
+          {
+            "description": "Same shape as `group_by`.",
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "limit": {
+        "default": 1000,
+        "exclusiveMinimum": 0,
+        "maximum": 9007199254740991,
+        "type": "integer"
+      },
+      "object": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "related_filters": {
+        "items": {
+          "properties": {
+            "filters": {
+              "default": [],
+              "items": {
+                "description": "Same shape as a `filters` item.",
+                "type": "object"
+              },
+              "maxItems": 5,
+              "type": "array"
+            },
+            "mode": {
+              "enum": [
+                "with",
+                "without"
+              ],
+              "type": "string"
+            },
+            "related": {
+              "minLength": 1,
+              "type": "string"
+            }
+          },
+          "required": [
+            "related",
+            "mode"
+          ],
+          "type": "object"
+        },
+        "maxItems": 3,
+        "type": "array"
+      },
+      "show_share": {
+        "type": "boolean"
+      },
+      "sort": {
+        "anyOf": [
+          {
+            "properties": {
+              "dir": {
+                "enum": [
+                  "asc",
+                  "desc"
+                ],
+                "type": "string"
+              },
+              "ref": {
+                "minLength": 1,
+                "type": "string"
+              }
+            },
+            "required": [
+              "ref",
+              "dir"
+            ],
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "version": {
+        "const": 1,
+        "type": "number"
+      },
+      "viz": {
+        "enum": [
+          "table",
+          "bar",
+          "stat",
+          "trend",
+          "donut",
+          "board",
+          "matrix",
+          "funnel",
+          "column",
+          "area"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "version",
+      "object"
+    ],
+    "type": "object"
+  }
+]

Changed1 schema field changedOct 20, 2026

changedInput schema / properties / definition / anyOf

Previous value: -[
-  {
-    "properties": {
-      "dashboard_filters": {
-        "properties": {
-          "filters": {
-            "items": {
-              "properties": {
-                "object": {
-                  "maxLength": 100,
-                  "minLength": 1,
-                  "type": "string"
-                },
-                "op": {
-                  "enum": [
-                    "eq",
-                    "gte",
-                    "lte",
-                    "in_period"
-                  ],
-                  "type": "string"
-                },
-                "ref": {
-                  "oneOf": [
-                    {
-                      "properties": {
-                        "field": {
-                          "minLength": 1,
-                          "type": "string"
-                        },
-                        "kind": {
-                          "const": "field",
-                          "type": "string"
-                        }
-                      },
-                      "required": [
-                        "kind",
-                        "field"
-                      ],
-                      "type": "object"
-                    },
-                    {
-                      "properties": {
-                        "key": {
-                          "minLength": 1,
-                          "type": "string"
-                        },
-                        "kind": {
-                          "const": "custom",
-                          "type": "string"
-                        }
-                      },
-                      "required": [
-                        "kind",
-                        "key"
-                      ],
-                      "type": "object"
-                    },
-                    {
-                      "properties": {
-                        "kind": {
-                          "const": "related",
-                          "type": "string"
-                        },
-                        "path": {
-                          "minLength": 1,
-                          "type": "string"
-                        }
-                      },
-                      "required": [
-                        "kind",
-                        "path"
-                      ],
-                      "type": "object"
-                    }
-                  ]
-                },
-                "value": {
-                  "maxLength": 1000,
-                  "minLength": 1,
-                  "type": "string"
-                }
-              },
-              "required": [
-                "ref",
-                "value"
-              ],
-              "type": "object"
-            },
-            "maxItems": 6,
-            "type": "array"
-          },
-          "period": {
-            "properties": {
-              "default": {
-                "enum": [
-                  "today",
-                  "yesterday",
-                  "this_week",
-                  "last_7_days",
-                  "next_7_days",
-                  "last_30_days",
-                  "next_30_days",
-                  "last_90_days",
-                  "this_month",
-                  "last_month",
-                  "this_quarter",
-                  "this_year",
-                  "overdue",
-                  "upcoming"
-                ],
-                "type": "string"
-              },
-              "enabled": {
-                "const": true,
-                "type": "boolean"
-              }
-            },
-            "required": [
-              "enabled"
-            ],
-            "type": "object"
-          }
-        },
-        "type": "object"
-      },
-      "kind": {
-        "const": "composition",
-        "type": "string"
-      },
-      "layout": {
-        "properties": {
-          "rows": {
-            "items": {
-              "properties": {
-                "widgetIds": {
-                  "items": {
-                    "minLength": 1,
-                    "type": "string"
-                  },
-                  "minItems": 1,
-                  "type": "array"
-                }
-              },
-              "required": [
-                "widgetIds"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          }
-        },
-        "required": [
-          "rows"
-        ],
-        "type": "object"
-      },
-      "title": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "version": {
-        "const": 1,
-        "type": "number"
-      },
-      "widgets": {
-        "items": {
-          "properties": {
-            "id": {
-              "minLength": 1,
-              "type": "string"
-            },
-            "pin_window": {
-              "type": "boolean"
-            },
-            "source_view_id": {
-              "minLength": 1,
-              "type": "string"
-            },
-            "spec": {
-              "description": "Inline ReportSpec for this panel — the same shape as the ReportSpec variant of this definition."
-            },
-            "title": {
-              "minLength": 1,
-              "type": "string"
-            },
-            "viz": {
-              "enum": [
-                "table",
-                "bar",
-                "stat",
-                "trend",
-                "donut",
-                "board",
-                "matrix",
-                "funnel",
-                "column",
-                "area"
-              ],
-              "type": "string"
-            },
-            "width": {
-              "anyOf": [
-                {
-                  "const": 2,
-                  "type": "number"
-                },
-                {
-                  "const": 3,
-                  "type": "number"
-                },
-                {
-                  "const": 4,
-                  "type": "number"
-                },
-                {
-                  "const": 6,
-                  "type": "number"
-                }
-              ]
-            }
-          },
-          "required": [
-            "id",
-            "title"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      }
-    },
-    "required": [
-      "version",
-      "kind",
-      "layout",
-      "widgets"
-    ],
-    "type": "object"
-  },
-  {
-    "properties": {
-      "kind": {
-        "const": "segment",
-        "type": "string"
-      },
-      "object": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "state": {
-        "properties": {
-          "conds": {
-            "items": {
-              "properties": {
-                "fieldKey": {
-                  "maxLength": 80,
-                  "minLength": 1,
-                  "type": "string"
-                },
-                "op": {
-                  "enum": [
-                    "contains",
-                    "eq",
-                    "is_null",
-                    "gte",
-                    "lt",
-                    "between",
-                    "in_next",
-                    "in_last",
-                    "overdue",
-                    "in",
-                    "not_in"
-                  ],
-                  "type": "string"
-                },
-                "value": {
-                  "anyOf": [
-                    {
-                      "maxLength": 120,
-                      "type": "string"
-                    },
-                    {
-                      "items": {
-                        "maxLength": 120,
-                        "minLength": 1,
-                        "type": "string"
-                      },
-                      "maxItems": 50,
-                      "minItems": 1,
-                      "type": "array"
-                    }
-                  ]
-                }
-              },
-              "required": [
-                "fieldKey",
-                "op"
-              ],
-              "type": "object"
-            },
-            "maxItems": 8,
-            "type": "array"
-          },
-          "filters": {
-            "additionalProperties": {
-              "maxLength": 120,
-              "minLength": 1,
-              "type": "string"
-            },
-            "propertyNames": {
-              "maxLength": 80,
-              "minLength": 1,
-              "type": "string"
-            },
-            "type": "object"
-          },
-          "match": {
-            "enum": [
-              "all",
-              "any"
-            ],
-            "type": "string"
-          },
-          "q": {
-            "maxLength": 200,
-            "minLength": 1,
-            "type": "string"
-          },
-          "seg": {
-            "maxLength": 64,
-            "minLength": 1,
-            "type": "string"
-          },
-          "sort": {
-            "maxLength": 64,
-            "minLength": 1,
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "version": {
-        "const": 1,
-        "type": "number"
-      }
-    },
-    "required": [
-      "version",
-      "kind",
-      "object",
-      "state"
-    ],
-    "type": "object"
-  },
-  {
-    "properties": {
-      "aggregations": {
-        "default": [],
-        "items": {
-          "properties": {
-            "alias": {
-              "minLength": 1,
-              "type": "string"
-            },
-            "fn": {
-              "enum": [
-                "count",
-                "count_distinct",
-                "sum",
-                "avg",
-                "min",
-                "max"
-              ],
-              "type": "string"
-            },
-            "ref": {
-              "oneOf": [
-                {
-                  "properties": {
-                    "field": {
-                      "minLength": 1,
-                      "type": "string"
-                    },
-                    "kind": {
-                      "const": "field",
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "kind",
-                    "field"
-                  ],
-                  "type": "object"
-                },
-                {
-                  "properties": {
-                    "key": {
-                      "minLength": 1,
-                      "type": "string"
-                    },
-                    "kind": {
-                      "const": "custom",
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "kind",
-                    "key"
-                  ],
-                  "type": "object"
-                },
-                {
-                  "properties": {
-                    "kind": {
-                      "const": "related",
-                      "type": "string"
-                    },
-                    "path": {
-                      "minLength": 1,
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "kind",
-                    "path"
-                  ],
-                  "type": "object"
-                }
-              ]
-            },
-            "where": {
-              "items": {
-                "properties": {
-                  "op": {
-                    "enum": [
-                      "eq",
-                      "neq",
-                      "gt",
-                      "gte",
-                      "lt",
-                      "lte",
-                      "contains",
-                      "starts_with",
-                      "in",
-                      "not_in",
-                      "has_any",
-                      "in_period",
-                      "is_null",
-                      "is_not_null"
-                    ],
-                    "type": "string"
-                  },
-                  "ref": {
-                    "oneOf": [
-                      {
-                        "properties": {
-                          "field": {
-                            "minLength": 1,
-                            "type": "string"
-                          },
-                          "kind": {
-                            "const": "field",
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "kind",
-                          "field"
-                        ],
-                        "type": "object"
-                      },
-                      {
-                        "properties": {
-                          "key": {
-                            "minLength": 1,
-                            "type": "string"
-                          },
-                          "kind": {
-                            "const": "custom",
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "kind",
-                          "key"
-                        ],
-                        "type": "object"
-                      },
-                      {
-                        "properties": {
-                          "kind": {
-                            "const": "related",
-                            "type": "string"
-                          },
-                          "path": {
-                            "minLength": 1,
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "kind",
-                          "path"
-                        ],
-                        "type": "object"
-                      }
-                    ]
-                  },
-                  "value": {}
-                },
-                "required": [
-                  "ref",
-                  "op"
-                ],
-                "type": "object"
-              },
-              "maxItems": 3,
-              "type": "array"
-            }
-          },
-          "required": [
-            "fn",
-            "alias"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "board_group": {
-        "oneOf": [
-          {
-            "properties": {
-              "field": {
-                "minLength": 1,
-                "type": "string"
-              },
-              "kind": {
-                "const": "field",
-                "type": "string"
-              }
-            },
-            "required": [
-              "kind",
-              "field"
-            ],
-            "type": "object"
-          },
-          {
-            "properties": {
-              "key": {
-                "minLength": 1,
-                "type": "string"
-              },
-              "kind": {
-                "const": "custom",
-                "type": "string"
-              }
-            },
-            "required": [
-              "kind",
-              "key"
-            ],
-            "type": "object"
-          },
-          {
-            "properties": {
-              "kind": {
-                "const": "related",
-                "type": "string"
-              },
-              "path": {
-                "minLength": 1,
-                "type": "string"
-              }
-            },
-            "required": [
-              "kind",
-              "path"
-            ],
-            "type": "object"
-          }
-        ]
-      },
-      "columns": {
-        "default": [],
-        "items": {
-          "oneOf": [
-            {
-              "properties": {
-                "field": {
-                  "minLength": 1,
-                  "type": "string"
-                },
-                "kind": {
-                  "const": "field",
-                  "type": "string"
-                }
-              },
-              "required": [
-                "kind",
-                "field"
-              ],
-              "type": "object"
-            },
-            {
-              "properties": {
-                "key": {
-                  "minLength": 1,
-                  "type": "string"
-                },
-                "kind": {
-                  "const": "custom",
-                  "type": "string"
-                }
-              },
-              "required": [
-                "kind",
-                "key"
-              ],
-              "type": "object"
-            },
-            {
-              "properties": {
-                "kind": {
-                  "const": "related",
-                  "type": "string"
-                },
-                "path": {
-                  "minLength": 1,
-                  "type": "string"
-                }
-              },
-              "required": [
-                "kind",
-                "path"
-              ],
-              "type": "object"
-            }
-          ]
-        },
-        "type": "array"
-      },
-      "compare": {
-        "enum": [
-          "previous_period"
-        ],
-        "type": "string"
-      },
-      "derived": {
-        "items": {
-          "properties": {
-            "alias": {
-              "minLength": 1,
-              "type": "string"
-            },
-            "denominator": {
-              "minLength": 1,
-              "type": "string"
-            },
-            "format": {
-              "enum": [
-                "percent",
-                "number"
-              ],
-              "type": "string"
-            },
-            "kind": {
-              "const": "ratio",
-              "type": "string"
-            },
-            "numerator": {
-              "minLength": 1,
-              "type": "string"
-            }
-          },
-          "required": [
-            "kind",
-            "numerator",
-            "denominator",
-            "alias"
-          ],
-          "type": "object"
-        },
-        "maxItems": 3,
-        "type": "array"
-      },
-      "filter_groups": {
-        "items": {
-          "properties": {
-            "filters": {
-              "items": {
-                "properties": {
-                  "op": {
-                    "enum": [
-                      "eq",
-                      "neq",
-                      "gt",
-                      "gte",
-                      "lt",
-                      "lte",
-                      "contains",
-                      "starts_with",
-                      "in",
-                      "not_in",
-                      "has_any",
-                      "in_period",
-                      "is_null",
-                      "is_not_null"
-                    ],
-                    "type": "string"
-                  },
-                  "ref": {
-                    "oneOf": [
-                      {
-                        "properties": {
-                          "field": {
-                            "minLength": 1,
-                            "type": "string"
-                          },
-                          "kind": {
-                            "const": "field",
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "kind",
-                          "field"
-                        ],
-                        "type": "object"
-                      },
-                      {
-                        "properties": {
-                          "key": {
-                            "minLength": 1,
-                            "type": "string"
-                          },
-                          "kind": {
-                            "const": "custom",
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "kind",
-                          "key"
-                        ],
-                        "type": "object"
-                      },
-                      {
-                        "properties": {
-                          "kind": {
-                            "const": "related",
-                            "type": "string"
-                          },
-                          "path": {
-                            "minLength": 1,
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "kind",
-                          "path"
-                        ],
-                        "type": "object"
-                      }
-                    ]
-                  },
-                  "value": {}
-                },
-                "required": [
-                  "ref",
-                  "op"
-                ],
-                "type": "object"
-              },
-              "maxItems": 6,
-              "minItems": 1,
-              "type": "array"
-            },
-            "mode": {
-              "enum": [
-                "any",
-                "none"
-              ],
-              "type": "string"
-            }
-          },
-          "required": [
-            "mode",
-            "filters"
-          ],
-          "type": "object"
-        },
-        "maxItems": 4,
-        "type": "array"
-      },
-      "filters": {
-        "default": [],
-        "items": {
-          "properties": {
-            "op": {
-              "enum": [
-                "eq",
-                "neq",
-                "gt",
-                "gte",
-                "lt",
-                "lte",
-                "contains",
-                "starts_with",
-                "in",
-                "not_in",
-                "has_any",
-                "in_period",
-                "is_null",
-                "is_not_null"
-              ],
-              "type": "string"
-            },
-            "ref": {
-              "oneOf": [
-                {
-                  "properties": {
-                    "field": {
-                      "minLength": 1,
-                      "type": "string"
-                    },
-                    "kind": {
-                      "const": "field",
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "kind",
-                    "field"
-                  ],
-                  "type": "object"
-                },
-                {
-                  "properties": {
-                    "key": {
-                      "minLength": 1,
-                      "type": "string"
-                    },
-                    "kind": {
-                      "const": "custom",
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "kind",
-                    "key"
-                  ],
-                  "type": "object"
-                },
-                {
-                  "properties": {
-                    "kind": {
-                      "const": "related",
-                      "type": "string"
-                    },
-                    "path": {
-                      "minLength": 1,
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "kind",
-                    "path"
-                  ],
-                  "type": "object"
-                }
-              ]
-            },
-            "value": {}
-          },
-          "required": [
-            "ref",
-            "op"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "group_by": {
-        "anyOf": [
-          {
-            "properties": {
-              "bucket": {
-                "enum": [
-                  "day",
-                  "week",
-                  "month",
-                  "quarter",
-                  "year"
-                ],
-                "type": "string"
-              },
-              "ref": {
-                "oneOf": [
-                  {
-                    "properties": {
-                      "field": {
-                        "minLength": 1,
-                        "type": "string"
-                      },
-                      "kind": {
-                        "const": "field",
-                        "type": "string"
-                      }
-                    },
-                    "required": [
-                      "kind",
-                      "field"
-                    ],
-                    "type": "object"
-                  },
-                  {
-                    "properties": {
-                      "key": {
-                        "minLength": 1,
-                        "type": "string"
-                      },
-                      "kind": {
-                        "const": "custom",
-                        "type": "string"
-                      }
-                    },
-                    "required": [
-                      "kind",
-                      "key"
-                    ],
-                    "type": "object"
-                  },
-                  {
-                    "properties": {
-                      "kind": {
-                        "const": "related",
-                        "type": "string"
-                      },
-                      "path": {
-                        "minLength": 1,
-                        "type": "string"
-                      }
-                    },
-                    "required": [
-                      "kind",
-                      "path"
-                    ],
-                    "type": "object"
-                  }
-                ]
-              }
-            },
-            "required": [
-              "ref"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "group_by_secondary": {
-        "anyOf": [
-          {
-            "properties": {
-              "bucket": {
-                "enum": [
-                  "day",
-                  "week",
-                  "month",
-                  "quarter",
-                  "year"
-                ],
-                "type": "string"
-              },
-              "ref": {
-                "oneOf": [
-                  {
-                    "properties": {
-                      "field": {
-                        "minLength": 1,
-                        "type": "string"
-                      },
-                      "kind": {
-                        "const": "field",
-                        "type": "string"
-                      }
-                    },
-                    "required": [
-                      "kind",
-                      "field"
-                    ],
-                    "type": "object"
-                  },
-                  {
-                    "properties": {
-                      "key": {
-                        "minLength": 1,
-                        "type": "string"
-                      },
-                      "kind": {
-                        "const": "custom",
-                        "type": "string"
-                      }
-                    },
-                    "required": [
-                      "kind",
-                      "key"
-                    ],
-                    "type": "object"
-                  },
-                  {
-                    "properties": {
-                      "kind": {
-                        "const": "related",
-                        "type": "string"
-                      },
-                      "path": {
-                        "minLength": 1,
-                        "type": "string"
-                      }
-                    },
-                    "required": [
-                      "kind",
-                      "path"
-                    ],
-                    "type": "object"
-                  }
-                ]
-              }
-            },
-            "required": [
-              "ref"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "limit": {
-        "default": 1000,
-        "exclusiveMinimum": 0,
-        "maximum": 9007199254740991,
-        "type": "integer"
-      },
-      "object": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "related_filters": {
-        "items": {
-          "properties": {
-            "filters": {
-              "default": [],
-              "items": {
-                "properties": {
-                  "op": {
-                    "enum": [
-                      "eq",
-                      "neq",
-                      "gt",
-                      "gte",
-                      "lt",
-                      "lte",
-                      "contains",
-                      "starts_with",
-                      "in",
-                      "not_in",
-                      "has_any",
-                      "in_period",
-                      "is_null",
-                      "is_not_null"
-                    ],
-                    "type": "string"
-                  },
-                  "ref": {
-                    "oneOf": [
-                      {
-                        "properties": {
-                          "field": {
-                            "minLength": 1,
-                            "type": "string"
-                          },
-                          "kind": {
-                            "const": "field",
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "kind",
-                          "field"
-                        ],
-                        "type": "object"
-                      },
-                      {
-                        "properties": {
-                          "key": {
-                            "minLength": 1,
-                            "type": "string"
-                          },
-                          "kind": {
-                            "const": "custom",
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "kind",
-                          "key"
-                        ],
-                        "type": "object"
-                      },
-                      {
-                        "properties": {
-                          "kind": {
-                            "const": "related",
-                            "type": "string"
-                          },
-                          "path": {
-                            "minLength": 1,
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "kind",
-                          "path"
-                        ],
-                        "type": "object"
-                      }
-                    ]
-                  },
-                  "value": {}
-                },
-                "required": [
-                  "ref",
-                  "op"
-                ],
-                "type": "object"
-              },
-              "maxItems": 5,
-              "type": "array"
-            },
-            "mode": {
-              "enum": [
-                "with",
-                "without"
-              ],
-              "type": "string"
-            },
-            "related": {
-              "minLength": 1,
-              "type": "string"
-            }
-          },
-          "required": [
-            "related",
-            "mode"
-          ],
-          "type": "object"
-        },
-        "maxItems": 3,
-        "type": "array"
-      },
-      "show_share": {
-        "type": "boolean"
-      },
-      "sort": {
-        "anyOf": [
-          {
-            "properties": {
-              "dir": {
-                "enum": [
-                  "asc",
-                  "desc"
-                ],
-                "type": "string"
-              },
-              "ref": {
-                "minLength": 1,
-                "type": "string"
-              }
-            },
-            "required": [
-              "ref",
-              "dir"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "version": {
-        "const": 1,
-        "type": "number"
-      },
-      "viz": {
-        "enum": [
-          "table",
-          "bar",
-          "stat",
-          "trend",
-          "donut",
-          "board",
-          "matrix",
-          "funnel",
-          "column",
-          "area"
-        ],
-        "type": "string"
-      }
-    },
-    "required": [
-      "version",
-      "object"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "properties": {
+      "dashboard_filters": {
+        "properties": {
+          "filters": {
+            "items": {
+              "properties": {
+                "object": {
+                  "maxLength": 100,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "op": {
+                  "enum": [
+                    "eq",
+                    "gte",
+                    "lte",
+                    "in_period"
+                  ],
+                  "type": "string"
+                },
+                "ref": {
+                  "description": "Same shape as a `columns` item of the ReportSpec variant (a column reference: kind field | custom | related).",
+                  "type": "object"
+                },
+                "value": {
+                  "maxLength": 1000,
+                  "minLength": 1,
+                  "type": "string"
+                }
+              },
+              "required": [
+                "ref",
+                "value"
+              ],
+              "type": "object"
+            },
+            "maxItems": 6,
+            "type": "array"
+          },
+          "period": {
+            "properties": {
+              "default": {
+                "enum": [
+                  "today",
+                  "yesterday",
+                  "this_week",
+                  "last_7_days",
+                  "next_7_days",
+                  "last_30_days",
+                  "next_30_days",
+                  "last_90_days",
+                  "this_month",
+                  "last_month",
+                  "this_quarter",
+                  "this_year",
+                  "overdue",
+                  "upcoming"
+                ],
+                "type": "string"
+              },
+              "enabled": {
+                "const": true,
+                "type": "boolean"
+              }
+            },
+            "required": [
+              "enabled"
+            ],
+            "type": "object"
+          }
+        },
+        "type": "object"
+      },
+      "kind": {
+        "const": "composition",
+        "type": "string"
+      },
+      "layout": {
+        "properties": {
+          "rows": {
+            "items": {
+              "properties": {
+                "widgetIds": {
+                  "items": {
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "minItems": 1,
+                  "type": "array"
+                }
+              },
+              "required": [
+                "widgetIds"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          }
+        },
+        "required": [
+          "rows"
+        ],
+        "type": "object"
+      },
+      "title": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "version": {
+        "const": 1,
+        "type": "number"
+      },
+      "widgets": {
+        "items": {
+          "properties": {
+            "id": {
+              "minLength": 1,
+              "type": "string"
+            },
+            "pin_window": {
+              "type": "boolean"
+            },
+            "source_view_id": {
+              "minLength": 1,
+              "type": "string"
+            },
+            "spec": {
+              "description": "Inline ReportSpec for this panel — the same shape as the ReportSpec variant of this definition."
+            },
+            "title": {
+              "minLength": 1,
+              "type": "string"
+            },
+            "viz": {
+              "enum": [
+                "table",
+                "bar",
+                "stat",
+                "trend",
+                "donut",
+                "board",
+                "matrix",
+                "funnel",
+                "column",
+                "area"
+              ],
+              "type": "string"
+            },
+            "width": {
+              "anyOf": [
+                {
+                  "const": 2,
+                  "type": "number"
+                },
+                {
+                  "const": 3,
+                  "type": "number"
+                },
+                {
+                  "const": 4,
+                  "type": "number"
+                },
+                {
+                  "const": 6,
+                  "type": "number"
+                }
+              ]
+            }
+          },
+          "required": [
+            "id",
+            "title"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "version",
+      "kind",
+      "layout",
+      "widgets"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "kind": {
+        "const": "segment",
+        "type": "string"
+      },
+      "object": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "state": {
+        "properties": {
+          "conds": {
+            "items": {
+              "properties": {
+                "fieldKey": {
+                  "maxLength": 80,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "op": {
+                  "enum": [
+                    "contains",
+                    "eq",
+                    "is_null",
+                    "gte",
+                    "lt",
+                    "between",
+                    "in_next",
+                    "in_last",
+                    "overdue",
+                    "in",
+                    "not_in"
+                  ],
+                  "type": "string"
+                },
+                "value": {
+                  "anyOf": [
+                    {
+                      "maxLength": 120,
+                      "type": "string"
+                    },
+                    {
+                      "items": {
+                        "maxLength": 120,
+                        "minLength": 1,
+                        "type": "string"
+                      },
+                      "maxItems": 50,
+                      "minItems": 1,
+                      "type": "array"
+                    }
+                  ]
+                }
+              },
+              "required": [
+                "fieldKey",
+                "op"
+              ],
+              "type": "object"
+            },
+            "maxItems": 8,
+            "type": "array"
+          },
+          "filters": {
+            "additionalProperties": {
+              "maxLength": 120,
+              "minLength": 1,
+              "type": "string"
+            },
+            "propertyNames": {
+              "maxLength": 80,
+              "minLength": 1,
+              "type": "string"
+            },
+            "type": "object"
+          },
+          "match": {
+            "enum": [
+              "all",
+              "any"
+            ],
+            "type": "string"
+          },
+          "q": {
+            "maxLength": 200,
+            "minLength": 1,
+            "type": "string"
+          },
+          "seg": {
+            "maxLength": 64,
+            "minLength": 1,
+            "type": "string"
+          },
+          "sort": {
+            "maxLength": 64,
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "version": {
+        "const": 1,
+        "type": "number"
+      }
+    },
+    "required": [
+      "version",
+      "kind",
+      "object",
+      "state"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "aggregations": {
+        "default": [],
+        "items": {
+          "properties": {
+            "alias": {
+              "minLength": 1,
+              "type": "string"
+            },
+            "fn": {
+              "enum": [
+                "count",
+                "count_distinct",
+                "sum",
+                "avg",
+                "min",
+                "max"
+              ],
+              "type": "string"
+            },
+            "ref": {
+              "description": "Same shape as a `columns` item of the ReportSpec variant (a column reference: kind field | custom | related).",
+              "type": "object"
+            },
+            "where": {
+              "items": {
+                "description": "Same shape as a `filters` item (field or custom refs with absolute operators).",
+                "type": "object"
+              },
+              "maxItems": 3,
+              "type": "array"
+            }
+          },
+          "required": [
+            "fn",
+            "alias"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "board_group": {
+        "description": "Same shape as a `columns` item of the ReportSpec variant (a column reference: kind field | custom | related).",
+        "type": "object"
+      },
+      "columns": {
+        "default": [],
+        "items": {
+          "oneOf": [
+            {
+              "properties": {
+                "field": {
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "kind": {
+                  "const": "field",
+                  "type": "string"
+                }
+              },
+              "required": [
+                "kind",
+                "field"
+              ],
+              "type": "object"
+            },
+            {
+              "properties": {
+                "key": {
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "kind": {
+                  "const": "custom",
+                  "type": "string"
+                }
+              },
+              "required": [
+                "kind",
+                "key"
+              ],
+              "type": "object"
+            },
+            {
+              "properties": {
+                "kind": {
+                  "const": "related",
+                  "type": "string"
+                },
+                "path": {
+                  "minLength": 1,
+                  "type": "string"
+                }
+              },
+              "required": [
+                "kind",
+                "path"
+              ],
+              "type": "object"
+            }
+          ]
+        },
+        "type": "array"
+      },
+      "compare": {
+        "enum": [
+          "previous_period"
+        ],
+        "type": "string"
+      },
+      "derived": {
+        "items": {
+          "properties": {
+            "alias": {
+              "minLength": 1,
+              "type": "string"
+            },
+            "denominator": {
+              "minLength": 1,
+              "type": "string"
+            },
+            "format": {
+              "enum": [
+                "percent",
+                "number"
+              ],
+              "type": "string"
+            },
+            "kind": {
+              "const": "ratio",
+              "type": "string"
+            },
+            "numerator": {
+              "minLength": 1,
+              "type": "string"
+            }
+          },
+          "required": [
+            "kind",
+            "numerator",
+            "denominator",
+            "alias"
+          ],
+          "type": "object"
+        },
+        "maxItems": 3,
+        "type": "array"
+      },
+      "filter_groups": {
+        "items": {
+          "properties": {
+            "filters": {
+              "items": {
+                "description": "Same shape as a `filters` item.",
+                "type": "object"
+              },
+              "maxItems": 6,
+              "minItems": 1,
+              "type": "array"
+            },
+            "mode": {
+              "enum": [
+                "any",
+                "none"
+              ],
+              "type": "string"
+            }
+          },
+          "required": [
+            "mode",
+            "filters"
+          ],
+          "type": "object"
+        },
+        "maxItems": 4,
+        "type": "array"
+      },
+      "filters": {
+        "default": [],
+        "items": {
+          "properties": {
+            "op": {
+              "enum": [
+                "eq",
+                "neq",
+                "gt",
+                "gte",
+                "lt",
+                "lte",
+                "contains",
+                "starts_with",
+                "in",
+                "not_in",
+                "has_any",
+                "in_period",
+                "is_null",
+                "is_not_null"
+              ],
+              "type": "string"
+            },
+            "ref": {
+              "description": "Same shape as a `columns` item of the ReportSpec variant (a column reference: kind field | custom | related).",
+              "type": "object"
+            },
+            "value": {}
+          },
+          "required": [
+            "ref",
+            "op"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "group_by": {
+        "anyOf": [
+          {
+            "properties": {
+              "bucket": {
+                "enum": [
+                  "day",
+                  "week",
+                  "month",
+                  "quarter",
+                  "year"
+                ],
+                "type": "string"
+              },
+              "ref": {
+                "description": "Same shape as a `columns` item of the ReportSpec variant (a column reference: kind field | custom | related).",
+                "type": "object"
+              }
+            },
+            "required": [
+              "ref"
+            ],
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "group_by_secondary": {
+        "anyOf": [
+          {
+            "description": "Same shape as `group_by`.",
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "limit": {
+        "default": 1000,
+        "exclusiveMinimum": 0,
+        "maximum": 9007199254740991,
+        "type": "integer"
+      },
+      "object": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "related_filters": {
+        "items": {
+          "properties": {
+            "filters": {
+              "default": [],
+              "items": {
+                "description": "Same shape as a `filters` item.",
+                "type": "object"
+              },
+              "maxItems": 5,
+              "type": "array"
+            },
+            "mode": {
+              "enum": [
+                "with",
+                "without"
+              ],
+              "type": "string"
+            },
+            "related": {
+              "minLength": 1,
+              "type": "string"
+            }
+          },
+          "required": [
+            "related",
+            "mode"
+          ],
+          "type": "object"
+        },
+        "maxItems": 3,
+        "type": "array"
+      },
+      "show_share": {
+        "type": "boolean"
+      },
+      "sort": {
+        "anyOf": [
+          {
+            "properties": {
+              "dir": {
+                "enum": [
+                  "asc",
+                  "desc"
+                ],
+                "type": "string"
+              },
+              "ref": {
+                "minLength": 1,
+                "type": "string"
+              }
+            },
+            "required": [
+              "ref",
+              "dir"
+            ],
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "version": {
+        "const": 1,
+        "type": "number"
+      },
+      "viz": {
+        "enum": [
+          "table",
+          "bar",
+          "stat",
+          "trend",
+          "donut",
+          "board",
+          "matrix",
+          "funnel",
+          "column",
+          "area"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "version",
+      "object"
+    ],
+    "type": "object"
+  }
+]

Changed1 schema field changedOct 20, 2026
- removedInput schema / $schema
```
Removed value: -"https://json-schema.org/draft/2020-12/schema"
```

Changed2 schema fields changedOct 20, 2026

removedInput schema / properties / report_id / pattern

Removed value: -"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"

removedInput schema / properties / source_view_id / pattern

Removed value: -"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"

Changed20 schema fields changedOct 19, 2026

removedOutput schema / $schema

Removed value: -"https://json-schema.org/draft/2020-12/schema"

removedOutput schema / additionalProperties
```
Removed value: -{}
```
removedOutput schema / properties / aggregations / items / additionalProperties
```
Removed value: -{}
```
removedOutput schema / properties / aggregations / items / propertyNames
```
Removed value: -{
-  "type": "string"
-}
```

changedOutput schema / properties / board_group / oneOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "field": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "kind": {
-        "const": "field",
-        "type": "string"
-      }
-    },
-    "required": [
-      "kind",
-      "field"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "key": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "kind": {
-        "const": "custom",
-        "type": "string"
-      }
-    },
-    "required": [
-      "kind",
-      "key"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "kind": {
-        "const": "related",
-        "type": "string"
-      },
-      "path": {
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "kind",
-      "path"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "properties": {
+      "field": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "kind": {
+        "const": "field",
+        "type": "string"
+      }
+    },
+    "required": [
+      "kind",
+      "field"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "key": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "kind": {
+        "const": "custom",
+        "type": "string"
+      }
+    },
+    "required": [
+      "kind",
+      "key"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "kind": {
+        "const": "related",
+        "type": "string"
+      },
+      "path": {
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "kind",
+      "path"
+    ],
+    "type": "object"
+  }
+]

removedOutput schema / properties / columns / items / additionalProperties
```
Removed value: -{}
```
removedOutput schema / properties / columns / items / propertyNames
```
Removed value: -{
-  "type": "string"
-}
```
removedOutput schema / properties / deltas / additionalProperties / additionalProperties
```
Removed value: -{}
```
removedOutput schema / properties / deltas / additionalProperties / propertyNames
```
Removed value: -{
-  "type": "string"
-}
```
removedOutput schema / properties / deltas / propertyNames
```
Removed value: -{
-  "type": "string"
-}
```

changedOutput schema / properties / group_ref / oneOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "field": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "kind": {
-        "const": "field",
-        "type": "string"
-      }
-    },
-    "required": [
-      "kind",
-      "field"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "key": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "kind": {
-        "const": "custom",
-        "type": "string"
-      }
-    },
-    "required": [
-      "kind",
-      "key"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "kind": {
-        "const": "related",
-        "type": "string"
-      },
-      "path": {
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "kind",
-      "path"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "properties": {
+      "field": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "kind": {
+        "const": "field",
+        "type": "string"
+      }
+    },
+    "required": [
+      "kind",
+      "field"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "key": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "kind": {
+        "const": "custom",
+        "type": "string"
+      }
+    },
+    "required": [
+      "kind",
+      "key"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "kind": {
+        "const": "related",
+        "type": "string"
+      },
+      "path": {
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "kind",
+      "path"
+    ],
+    "type": "object"
+  }
+]

changedOutput schema / properties / group_ref_secondary / oneOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "field": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "kind": {
-        "const": "field",
-        "type": "string"
-      }
-    },
-    "required": [
-      "kind",
-      "field"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "key": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "kind": {
-        "const": "custom",
-        "type": "string"
-      }
-    },
-    "required": [
-      "kind",
-      "key"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "kind": {
-        "const": "related",
-        "type": "string"
-      },
-      "path": {
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "kind",
-      "path"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "properties": {
+      "field": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "kind": {
+        "const": "field",
+        "type": "string"
+      }
+    },
+    "required": [
+      "kind",
+      "field"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "key": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "kind": {
+        "const": "custom",
+        "type": "string"
+      }
+    },
+    "required": [
+      "kind",
+      "key"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "kind": {
+        "const": "related",
+        "type": "string"
+      },
+      "path": {
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "kind",
+      "path"
+    ],
+    "type": "object"
+  }
+]

removedOutput schema / properties / layout / additionalProperties
```
Removed value: -{}
```
removedOutput schema / properties / layout / propertyNames
```
Removed value: -{
-  "type": "string"
-}
```
removedOutput schema / properties / rows / items / additionalProperties
```
Removed value: -{}
```
removedOutput schema / properties / rows / items / propertyNames
```
Removed value: -{
-  "type": "string"
-}
```
removedOutput schema / properties / spec / additionalProperties
```
Removed value: -{}
```
removedOutput schema / properties / spec / propertyNames
```
Removed value: -{
-  "type": "string"
-}
```
removedOutput schema / properties / widgets / items / additionalProperties
```
Removed value: -{}
```
removedOutput schema / properties / widgets / items / propertyNames
```
Removed value: -{
-  "type": "string"
-}
```

Changed1 schema field changedOct 19, 2026

changedInput schema / properties / definition / anyOf

Previous value: -[
-  {
-    "properties": {
-      "dashboard_filters": {
-        "properties": {
-          "filters": {
-            "items": {
-              "properties": {
-                "object": {
-                  "maxLength": 100,
-                  "minLength": 1,
-                  "type": "string"
-                },
-                "op": {
-                  "enum": [
-                    "eq",
-                    "gte",
-                    "lte",
-                    "in_period"
-                  ],
-                  "type": "string"
-                },
-                "ref": {
-                  "oneOf": [
-                    {
-                      "properties": {
-                        "field": {
-                          "minLength": 1,
-                          "type": "string"
-                        },
-                        "kind": {
-                          "const": "field",
-                          "type": "string"
-                        }
-                      },
-                      "required": [
-                        "kind",
-                        "field"
-                      ],
-                      "type": "object"
-                    },
-                    {
-                      "properties": {
-                        "key": {
-                          "minLength": 1,
-                          "type": "string"
-                        },
-                        "kind": {
-                          "const": "custom",
-                          "type": "string"
-                        }
-                      },
-                      "required": [
-                        "kind",
-                        "key"
-                      ],
-                      "type": "object"
-                    },
-                    {
-                      "properties": {
-                        "kind": {
-                          "const": "related",
-                          "type": "string"
-                        },
-                        "path": {
-                          "minLength": 1,
-                          "type": "string"
-                        }
-                      },
-                      "required": [
-                        "kind",
-                        "path"
-                      ],
-                      "type": "object"
-                    }
-                  ]
-                },
-                "value": {
-                  "maxLength": 1000,
-                  "minLength": 1,
-                  "type": "string"
-                }
-              },
-              "required": [
-                "ref",
-                "value"
-              ],
-              "type": "object"
-            },
-            "maxItems": 6,
-            "type": "array"
-          },
-          "period": {
-            "properties": {
-              "default": {
-                "enum": [
-                  "today",
-                  "yesterday",
-                  "this_week",
-                  "last_7_days",
-                  "next_7_days",
-                  "last_30_days",
-                  "next_30_days",
-                  "last_90_days",
-                  "this_month",
-                  "last_month",
-                  "this_quarter",
-                  "this_year",
-                  "overdue",
-                  "upcoming"
-                ],
-                "type": "string"
-              },
-              "enabled": {
-                "const": true,
-                "type": "boolean"
-              }
-            },
-            "required": [
-              "enabled"
-            ],
-            "type": "object"
-          }
-        },
-        "type": "object"
-      },
-      "kind": {
-        "const": "composition",
-        "type": "string"
-      },
-      "layout": {
-        "properties": {
-          "rows": {
-            "items": {
-              "properties": {
-                "widgetIds": {
-                  "items": {
-                    "minLength": 1,
-                    "type": "string"
-                  },
-                  "minItems": 1,
-                  "type": "array"
-                }
-              },
-              "required": [
-                "widgetIds"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          }
-        },
-        "required": [
-          "rows"
-        ],
-        "type": "object"
-      },
-      "title": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "version": {
-        "const": 1,
-        "type": "number"
-      },
-      "widgets": {
-        "items": {
-          "properties": {
-            "id": {
-              "minLength": 1,
-              "type": "string"
-            },
-            "pin_window": {
-              "type": "boolean"
-            },
-            "source_view_id": {
-              "minLength": 1,
-              "type": "string"
-            },
-            "spec": {
-              "properties": {
-                "aggregations": {
-                  "default": [],
-                  "items": {
-                    "properties": {
-                      "alias": {
-                        "minLength": 1,
-                        "type": "string"
-                      },
-                      "fn": {
-                        "enum": [
-                          "count",
-                          "count_distinct",
-                          "sum",
-                          "avg",
-                          "min",
-                          "max"
-                        ],
-                        "type": "string"
-                      },
-                      "ref": {
-                        "oneOf": [
-                          {
-                            "properties": {
-                              "field": {
-                                "minLength": 1,
-                                "type": "string"
-                              },
-                              "kind": {
-                                "const": "field",
-                                "type": "string"
-                              }
-                            },
-                            "required": [
-                              "kind",
-                              "field"
-                            ],
-                            "type": "object"
-                          },
-                          {
-                            "properties": {
-                              "key": {
-                                "minLength": 1,
-                                "type": "string"
-                              },
-                              "kind": {
-                                "const": "custom",
-                                "type": "string"
-                              }
-                            },
-                            "required": [
-                              "kind",
-                              "key"
-                            ],
-                            "type": "object"
-                          },
-                          {
-                            "properties": {
-                              "kind": {
-                                "const": "related",
-                                "type": "string"
-                              },
-                              "path": {
-                                "minLength": 1,
-                                "type": "string"
-                              }
-                            },
-                            "required": [
-                              "kind",
-                              "path"
-                            ],
-                            "type": "object"
-                          }
-                        ]
-                      },
-                      "where": {
-                        "items": {
-                          "properties": {
-                            "op": {
-                              "enum": [
-                                "eq",
-                                "neq",
-                                "gt",
-                                "gte",
-                                "lt",
-                                "lte",
-                                "contains",
-                                "starts_with",
-                                "in",
-                                "not_in",
-                                "has_any",
-                                "in_period",
-                                "is_null",
-                                "is_not_null"
-                              ],
-                              "type": "string"
-                            },
-                            "ref": {
-                              "oneOf": [
-                                {
-                                  "properties": {
-                                    "field": {
-                                      "minLength": 1,
-                                      "type": "string"
-                                    },
-                                    "kind": {
-                                      "const": "field",
-                                      "type": "string"
-                                    }
-                                  },
-                                  "required": [
-                                    "kind",
-                                    "field"
-                                  ],
-                                  "type": "object"
-                                },
-                                {
-                                  "properties": {
-                                    "key": {
-                                      "minLength": 1,
-                                      "type": "string"
-                                    },
-                                    "kind": {
-                                      "const": "custom",
-                                      "type": "string"
-                                    }
-                                  },
-                                  "required": [
-                                    "kind",
-                                    "key"
-                                  ],
-                                  "type": "object"
-                                },
-                                {
-                                  "properties": {
-                                    "kind": {
-                                      "const": "related",
-                                      "type": "string"
-                                    },
-                                    "path": {
-                                      "minLength": 1,
-                                      "type": "string"
-                                    }
-                                  },
-                                  "required": [
-                                    "kind",
-                                    "path"
-                                  ],
-                                  "type": "object"
-                                }
-                              ]
-                            },
-                            "value": {}
-                          },
-                          "required": [
-                            "ref",
-                            "op"
-                          ],
-                          "type": "object"
-                        },
-                        "maxItems": 3,
-                        "type": "array"
-                      }
-                    },
-                    "required": [
-                      "fn",
-                      "alias"
-                    ],
-                    "type": "object"
-                  },
-                  "type": "array"
-                },
-                "board_group": {
-                  "oneOf": [
-                    {
-                      "properties": {
-                        "field": {
-                          "minLength": 1,
-                          "type": "string"
-                        },
-                        "kind": {
-                          "const": "field",
-                          "type": "string"
-                        }
-                      },
-                      "required": [
-                        "kind",
-                        "field"
-                      ],
-                      "type": "object"
-                    },
-                    {
-                      "properties": {
-                        "key": {
-                          "minLength": 1,
-                          "type": "string"
-                        },
-                        "kind": {
-                          "const": "custom",
-                          "type": "string"
-                        }
-                      },
-                      "required": [
-                        "kind",
-                        "key"
-                      ],
-                      "type": "object"
-                    },
-                    {
-                      "properties": {
-                        "kind": {
-                          "const": "related",
-                          "type": "string"
-                        },
-                        "path": {
-                          "minLength": 1,
-                          "type": "string"
-                        }
-                      },
-                      "required": [
-                        "kind",
-                        "path"
-                      ],
-                      "type": "object"
-                    }
-                  ]
-                },
-                "columns": {
-                  "default": [],
-                  "items": {
-                    "oneOf": [
-                      {
-                        "properties": {
-                          "field": {
-                            "minLength": 1,
-                            "type": "string"
-                          },
-                          "kind": {
-                            "const": "field",
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "kind",
-                          "field"
-                        ],
-                        "type": "object"
-                      },
-                      {
-                        "properties": {
-                          "key": {
-                            "minLength": 1,
-                            "type": "string"
-                          },
-                          "kind": {
-                            "const": "custom",
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "kind",
-                          "key"
-                        ],
-                        "type": "object"
-                      },
-                      {
-                        "properties": {
-                          "kind": {
-                            "const": "related",
-                            "type": "string"
-                          },
-                          "path": {
-                            "minLength": 1,
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "kind",
-                          "path"
-                        ],
-                        "type": "object"
-                      }
-                    ]
-                  },
-                  "type": "array"
-                },
-                "compare": {
-                  "enum": [
-                    "previous_period"
-                  ],
-                  "type": "string"
-                },
-                "derived": {
-                  "items": {
-                    "properties": {
-                      "alias": {
-                        "minLength": 1,
-                        "type": "string"
-                      },
-                      "denominator": {
-                        "minLength": 1,
-                        "type": "string"
-                      },
-                      "format": {
-                        "enum": [
-                          "percent",
-                          "number"
-                        ],
-                        "type": "string"
-                      },
-                      "kind": {
-                        "const": "ratio",
-                        "type": "string"
-                      },
-                      "numerator": {
-                        "minLength": 1,
-                        "type": "string"
-                      }
-                    },
-                    "required": [
-                      "kind",
-                      "numerator",
-                      "denominator",
-                      "alias"
-                    ],
-                    "type": "object"
-                  },
-                  "maxItems": 3,
-                  "type": "array"
-                },
-                "filter_groups": {
-                  "items": {
-                    "properties": {
-                      "filters": {
-                        "items": {
-                          "properties": {
-                            "op": {
-                              "enum": [
-                                "eq",
-                                "neq",
-                                "gt",
-                                "gte",
-                                "lt",
-                                "lte",
-                                "contains",
-                                "starts_with",
-                                "in",
-                                "not_in",
-                                "has_any",
-                                "in_period",
-                                "is_null",
-                                "is_not_null"
-                              ],
-                              "type": "string"
-                            },
-                            "ref": {
-                              "oneOf": [
-                                {
-                                  "properties": {
-                                    "field": {
-                                      "minLength": 1,
-                                      "type": "string"
-                                    },
-                                    "kind": {
-                                      "const": "field",
-                                      "type": "string"
-                                    }
-                                  },
-                                  "required": [
-                                    "kind",
-                                    "field"
-                                  ],
-                                  "type": "object"
-                                },
-                                {
-                                  "properties": {
-                                    "key": {
-                                      "minLength": 1,
-                                      "type": "string"
-                                    },
-                                    "kind": {
-                                      "const": "custom",
-                                      "type": "string"
-                                    }
-                                  },
-                                  "required": [
-                                    "kind",
-                                    "key"
-                                  ],
-                                  "type": "object"
-                                },
-                                {
-                                  "properties": {
-                                    "kind": {
-                                      "const": "related",
-                                      "type": "string"
-                                    },
-                                    "path": {
-                                      "minLength": 1,
-                                      "type": "string"
-                                    }
-                                  },
-                                  "required": [
-                                    "kind",
-                                    "path"
-                                  ],
-                                  "type": "object"
-                                }
-                              ]
-                            },
-                            "value": {}
-                          },
-                          "required": [
-                            "ref",
-                            "op"
-                          ],
-                          "type": "object"
-                        },
-                        "maxItems": 6,
-                        "minItems": 1,
-                        "type": "array"
-                      },
-                      "mode": {
-                        "enum": [
-                          "any",
-                          "none"
-                        ],
-                        "type": "string"
-                      }
-                    },
-                    "required": [
-                      "mode",
-                      "filters"
-                    ],
-                    "type": "object"
-                  },
-                  "maxItems": 4,
-                  "type": "array"
-                },
-                "filters": {
-                  "default": [],
-                  "items": {
-                    "properties": {
-                      "op": {
-                        "enum": [
-                          "eq",
-                          "neq",
-                          "gt",
-                          "gte",
-                          "lt",
-                          "lte",
-                          "contains",
-                          "starts_with",
-                          "in",
-                          "not_in",
-                          "has_any",
-                          "in_period",
-                          "is_null",
-                          "is_not_null"
-                        ],
-                        "type": "string"
-                      },
-                      "ref": {
-                        "oneOf": [
-                          {
-                            "properties": {
-                              "field": {
-                                "minLength": 1,
-                                "type": "string"
-                              },
-                              "kind": {
-                                "const": "field",
-                                "type": "string"
-                              }
-                            },
-                            "required": [
-                              "kind",
-                              "field"
-                            ],
-                            "type": "object"
-                          },
-                          {
-                            "properties": {
-                              "key": {
-                                "minLength": 1,
-                                "type": "string"
-                              },
-                              "kind": {
-                                "const": "custom",
-                                "type": "string"
-                              }
-                            },
-                            "required": [
-                              "kind",
-                              "key"
-                            ],
-                            "type": "object"
-                          },
-                          {
-                            "properties": {
-                              "kind": {
-                                "const": "related",
-                                "type": "string"
-                              },
-                              "path": {
-                                "minLength": 1,
-                                "type": "string"
-                              }
-                            },
-                            "required": [
-                              "kind",
-                              "path"
-                            ],
-                            "type": "object"
-                          }
-                        ]
-                      },
-                      "value": {}
-                    },
-                    "required": [
-                      "ref",
-                      "op"
-                    ],
-                    "type": "object"
-                  },
-                  "type": "array"
-                },
-                "group_by": {
-                  "anyOf": [
-                    {
-                      "properties": {
-                        "bucket": {
-                          "enum": [
-                            "day",
-                            "week",
-                            "month",
-                            "quarter",
-                            "year"
-                          ],
-                          "type": "string"
-                        },
-                        "ref": {
-                          "oneOf": [
-                            {
-                              "properties": {
-                                "field": {
-                                  "minLength": 1,
-                                  "type": "string"
-                                },
-                                "kind": {
-                                  "const": "field",
-                                  "type": "string"
-                                }
-                              },
-                              "required": [
-                                "kind",
-                                "field"
-                              ],
-                              "type": "object"
-                            },
-                            {
-                              "properties": {
-                                "key": {
-                                  "minLength": 1,
-                                  "type": "string"
-                                },
-                                "kind": {
-                                  "const": "custom",
-                                  "type": "string"
-                                }
-                              },
-                              "required": [
-                                "kind",
-                                "key"
-                              ],
-                              "type": "object"
-                            },
-                            {
-                              "properties": {
-                                "kind": {
-                                  "const": "related",
-                                  "type": "string"
-                                },
-                                "path": {
-                                  "minLength": 1,
-                                  "type": "string"
-                                }
-                              },
-                              "required": [
-                                "kind",
-                                "path"
-                              ],
-                              "type": "object"
-                            }
-                          ]
-                        }
-                      },
-                      "required": [
-                        "ref"
-                      ],
-                      "type": "object"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                },
-                "group_by_secondary": {
-                  "anyOf": [
-                    {
-                      "properties": {
-                        "bucket": {
-                          "enum": [
-                            "day",
-                            "week",
-                            "month",
-                            "quarter",
-                            "year"
-                          ],
-                          "type": "string"
-                        },
-                        "ref": {
-                          "oneOf": [
-                            {
-                              "properties": {
-                                "field": {
-                                  "minLength": 1,
-                                  "type": "string"
-                                },
-                                "kind": {
-                                  "const": "field",
-                                  "type": "string"
-                                }
-                              },
-                              "required": [
-                                "kind",
-                                "field"
-                              ],
-                              "type": "object"
-                            },
-                            {
-                              "properties": {
-                                "key": {
-                                  "minLength": 1,
-                                  "type": "string"
-                                },
-                                "kind": {
-                                  "const": "custom",
-                                  "type": "string"
-                                }
-                              },
-                              "required": [
-                                "kind",
-                                "key"
-                              ],
-                              "type": "object"
-                            },
-                            {
-                              "properties": {
-                                "kind": {
-                                  "const": "related",
-                                  "type": "string"
-                                },
-                                "path": {
-                                  "minLength": 1,
-                                  "type": "string"
-                                }
-                              },
-                              "required": [
-                                "kind",
-                                "path"
-                              ],
-                              "type": "object"
-                            }
-                          ]
-                        }
-                      },
-                      "required": [
-                        "ref"
-                      ],
-                      "type": "object"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                },
-                "limit": {
-                  "default": 1000,
-                  "exclusiveMinimum": 0,
-                  "maximum": 9007199254740991,
-                  "type": "integer"
-                },
-                "object": {
-                  "minLength": 1,
-                  "type": "string"
-                },
-                "related_filters": {
-                  "items": {
-                    "properties": {
-                      "filters": {
-                        "default": [],
-                        "items": {
-                          "properties": {
-                            "op": {
-                              "enum": [
-                                "eq",
-                                "neq",
-                                "gt",
-                                "gte",
-                                "lt",
-                                "lte",
-                                "contains",
-                                "starts_with",
-                                "in",
-                                "not_in",
-                                "has_any",
-                                "in_period",
-                                "is_null",
-                                "is_not_null"
-                              ],
-                              "type": "string"
-                            },
-                            "ref": {
-                              "oneOf": [
-                                {
-                                  "properties": {
-                                    "field": {
-                                      "minLength": 1,
-                                      "type": "string"
-                                    },
-                                    "kind": {
-                                      "const": "field",
-                                      "type": "string"
-                                    }
-                                  },
-                                  "required": [
-                                    "kind",
-                                    "field"
-                                  ],
-                                  "type": "object"
-                                },
-                                {
-                                  "properties": {
-                                    "key": {
-                                      "minLength": 1,
-                                      "type": "string"
-                                    },
-                                    "kind": {
-                                      "const": "custom",
-                                      "type": "string"
-                                    }
-                                  },
-                                  "required": [
-                                    "kind",
-                                    "key"
-                                  ],
-                                  "type": "object"
-                                },
-                                {
-                                  "properties": {
-                                    "kind": {
-                                      "const": "related",
-                                      "type": "string"
-                                    },
-                                    "path": {
-                                      "minLength": 1,
-                                      "type": "string"
-                                    }
-                                  },
-                                  "required": [
-                                    "kind",
-                                    "path"
-                                  ],
-                                  "type": "object"
-                                }
-                              ]
-                            },
-                            "value": {}
-                          },
-                          "required": [
-                            "ref",
-                            "op"
-                          ],
-                          "type": "object"
-                        },
-                        "maxItems": 5,
-                        "type": "array"
-                      },
-                      "mode": {
-                        "enum": [
-                          "with",
-                          "without"
-                        ],
-                        "type": "string"
-                      },
-                      "related": {
-                        "minLength": 1,
-                        "type": "string"
-                      }
-                    },
-                    "required": [
-                      "related",
-                      "mode"
-                    ],
-                    "type": "object"
-                  },
-                  "maxItems": 3,
-                  "type": "array"
-                },
-                "show_share": {
-                  "type": "boolean"
-                },
-                "sort": {
-                  "anyOf": [
-                    {
-                      "properties": {
-                        "dir": {
-                          "enum": [
-                            "asc",
-                            "desc"
-                          ],
-                          "type": "string"
-                        },
-                        "ref": {
-                          "minLength": 1,
-                          "type": "string"
-                        }
-                      },
-                      "required": [
-                        "ref",
-                        "dir"
-                      ],
-                      "type": "object"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                },
-                "version": {
-                  "const": 1,
-                  "type": "number"
-                },
-                "viz": {
-                  "enum": [
-                    "table",
-                    "bar",
-                    "stat",
-                    "trend",
-                    "donut",
-                    "board",
-                    "matrix",
-                    "funnel",
-                    "column",
-                    "area"
-                  ],
-                  "type": "string"
-                }
-              },
-              "required": [
-                "version",
-                "object"
-              ],
-              "type": "object"
-            },
-            "title": {
-              "minLength": 1,
-              "type": "string"
-            },
-            "viz": {
-              "enum": [
-                "table",
-                "bar",
-                "stat",
-                "trend",
-                "donut",
-                "board",
-                "matrix",
-                "funnel",
-                "column",
-                "area"
-              ],
-              "type": "string"
-            },
-            "width": {
-              "anyOf": [
-                {
-                  "const": 2,
-                  "type": "number"
-                },
-                {
-                  "const": 3,
-                  "type": "number"
-                },
-                {
-                  "const": 4,
-                  "type": "number"
-                },
-                {
-                  "const": 6,
-                  "type": "number"
-                }
-              ]
-            }
-          },
-          "required": [
-            "id",
-            "title"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      }
-    },
-    "required": [
-      "version",
-      "kind",
-      "layout",
-      "widgets"
-    ],
-    "type": "object"
-  },
-  {
-    "properties": {
-      "kind": {
-        "const": "segment",
-        "type": "string"
-      },
-      "object": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "state": {
-        "properties": {
-          "conds": {
-            "items": {
-              "properties": {
-                "fieldKey": {
-                  "maxLength": 80,
-                  "minLength": 1,
-                  "type": "string"
-                },
-                "op": {
-                  "enum": [
-                    "contains",
-                    "eq",
-                    "is_null",
-                    "gte",
-                    "lt",
-                    "between",
-                    "in_next",
-                    "in_last",
-                    "overdue",
-                    "in",
-                    "not_in"
-                  ],
-                  "type": "string"
-                },
-                "value": {
-                  "anyOf": [
-                    {
-                      "maxLength": 120,
-                      "type": "string"
-                    },
-                    {
-                      "items": {
-                        "maxLength": 120,
-                        "minLength": 1,
-                        "type": "string"
-                      },
-                      "maxItems": 50,
-                      "minItems": 1,
-                      "type": "array"
-                    }
-                  ]
-                }
-              },
-              "required": [
-                "fieldKey",
-                "op"
-              ],
-              "type": "object"
-            },
-            "maxItems": 8,
-            "type": "array"
-          },
-          "filters": {
-            "additionalProperties": {
-              "maxLength": 120,
-              "minLength": 1,
-              "type": "string"
-            },
-            "propertyNames": {
-              "maxLength": 80,
-              "minLength": 1,
-              "type": "string"
-            },
-            "type": "object"
-          },
-          "match": {
-            "enum": [
-              "all",
-              "any"
-            ],
-            "type": "string"
-          },
-          "q": {
-            "maxLength": 200,
-            "minLength": 1,
-            "type": "string"
-          },
-          "seg": {
-            "maxLength": 64,
-            "minLength": 1,
-            "type": "string"
-          },
-          "sort": {
-            "maxLength": 64,
-            "minLength": 1,
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "version": {
-        "const": 1,
-        "type": "number"
-      }
-    },
-    "required": [
-      "version",
-      "kind",
-      "object",
-      "state"
-    ],
-    "type": "object"
-  },
-  {
-    "properties": {
-      "aggregations": {
-        "default": [],
-        "items": {
-          "properties": {
-            "alias": {
-              "minLength": 1,
-              "type": "string"
-            },
-            "fn": {
-              "enum": [
-                "count",
-                "count_distinct",
-                "sum",
-                "avg",
-                "min",
-                "max"
-              ],
-              "type": "string"
-            },
-            "ref": {
-              "oneOf": [
-                {
-                  "properties": {
-                    "field": {
-                      "minLength": 1,
-                      "type": "string"
-                    },
-                    "kind": {
-                      "const": "field",
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "kind",
-                    "field"
-                  ],
-                  "type": "object"
-                },
-                {
-                  "properties": {
-                    "key": {
-                      "minLength": 1,
-                      "type": "string"
-                    },
-                    "kind": {
-                      "const": "custom",
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "kind",
-                    "key"
-                  ],
-                  "type": "object"
-                },
-                {
-                  "properties": {
-                    "kind": {
-                      "const": "related",
-                      "type": "string"
-                    },
-                    "path": {
-                      "minLength": 1,
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "kind",
-                    "path"
-                  ],
-                  "type": "object"
-                }
-              ]
-            },
-            "where": {
-              "items": {
-                "properties": {
-                  "op": {
-                    "enum": [
-                      "eq",
-                      "neq",
-                      "gt",
-                      "gte",
-                      "lt",
-                      "lte",
-                      "contains",
-                      "starts_with",
-                      "in",
-                      "not_in",
-                      "has_any",
-                      "in_period",
-                      "is_null",
-                      "is_not_null"
-                    ],
-                    "type": "string"
-                  },
-                  "ref": {
-                    "oneOf": [
-                      {
-                        "properties": {
-                          "field": {
-                            "minLength": 1,
-                            "type": "string"
-                          },
-                          "kind": {
-                            "const": "field",
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "kind",
-                          "field"
-                        ],
-                        "type": "object"
-                      },
-                      {
-                        "properties": {
-                          "key": {
-                            "minLength": 1,
-                            "type": "string"
-                          },
-                          "kind": {
-                            "const": "custom",
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "kind",
-                          "key"
-                        ],
-                        "type": "object"
-                      },
-                      {
-                        "properties": {
-                          "kind": {
-                            "const": "related",
-                            "type": "string"
-                          },
-                          "path": {
-                            "minLength": 1,
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "kind",
-                          "path"
-                        ],
-                        "type": "object"
-                      }
-                    ]
-                  },
-                  "value": {}
-                },
-                "required": [
-                  "ref",
-                  "op"
-                ],
-                "type": "object"
-              },
-              "maxItems": 3,
-              "type": "array"
-            }
-          },
-          "required": [
-            "fn",
-            "alias"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "board_group": {
-        "oneOf": [
-          {
-            "properties": {
-              "field": {
-                "minLength": 1,
-                "type": "string"
-              },
-              "kind": {
-                "const": "field",
-                "type": "string"
-              }
-            },
-            "required": [
-              "kind",
-              "field"
-            ],
-            "type": "object"
-          },
-          {
-            "properties": {
-              "key": {
-                "minLength": 1,
-                "type": "string"
-              },
-              "kind": {
-                "const": "custom",
-                "type": "string"
-              }
-            },
-            "required": [
-              "kind",
-              "key"
-            ],
-            "type": "object"
-          },
-          {
-            "properties": {
-              "kind": {
-                "const": "related",
-                "type": "string"
-              },
-              "path": {
-                "minLength": 1,
-                "type": "string"
-              }
-            },
-            "required": [
-              "kind",
-              "path"
-            ],
-            "type": "object"
-          }
-        ]
-      },
-      "columns": {
-        "default": [],
-        "items": {
-          "oneOf": [
-            {
-              "properties": {
-                "field": {
-                  "minLength": 1,
-                  "type": "string"
-                },
-                "kind": {
-                  "const": "field",
-                  "type": "string"
-                }
-              },
-              "required": [
-                "kind",
-                "field"
-              ],
-              "type": "object"
-            },
-            {
-              "properties": {
-                "key": {
-                  "minLength": 1,
-                  "type": "string"
-                },
-                "kind": {
-                  "const": "custom",
-                  "type": "string"
-                }
-              },
-              "required": [
-                "kind",
-                "key"
-              ],
-              "type": "object"
-            },
-            {
-              "properties": {
-                "kind": {
-                  "const": "related",
-                  "type": "string"
-                },
-                "path": {
-                  "minLength": 1,
-                  "type": "string"
-                }
-              },
-              "required": [
-                "kind",
-                "path"
-              ],
-              "type": "object"
-            }
-          ]
-        },
-        "type": "array"
-      },
-      "compare": {
-        "enum": [
-          "previous_period"
-        ],
-        "type": "string"
-      },
-      "derived": {
-        "items": {
-          "properties": {
-            "alias": {
-              "minLength": 1,
-              "type": "string"
-            },
-            "denominator": {
-              "minLength": 1,
-              "type": "string"
-            },
-            "format": {
-              "enum": [
-                "percent",
-                "number"
-              ],
-              "type": "string"
-            },
-            "kind": {
-              "const": "ratio",
-              "type": "string"
-            },
-            "numerator": {
-              "minLength": 1,
-              "type": "string"
-            }
-          },
-          "required": [
-            "kind",
-            "numerator",
-            "denominator",
-            "alias"
-          ],
-          "type": "object"
-        },
-        "maxItems": 3,
-        "type": "array"
-      },
-      "filter_groups": {
-        "items": {
-          "properties": {
-            "filters": {
-              "items": {
-                "properties": {
-                  "op": {
-                    "enum": [
-                      "eq",
-                      "neq",
-                      "gt",
-                      "gte",
-                      "lt",
-                      "lte",
-                      "contains",
-                      "starts_with",
-                      "in",
-                      "not_in",
-                      "has_any",
-                      "in_period",
-                      "is_null",
-                      "is_not_null"
-                    ],
-                    "type": "string"
-                  },
-                  "ref": {
-                    "oneOf": [
-                      {
-                        "properties": {
-                          "field": {
-                            "minLength": 1,
-                            "type": "string"
-                          },
-                          "kind": {
-                            "const": "field",
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "kind",
-                          "field"
-                        ],
-                        "type": "object"
-                      },
-                      {
-                        "properties": {
-                          "key": {
-                            "minLength": 1,
-                            "type": "string"
-                          },
-                          "kind": {
-                            "const": "custom",
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "kind",
-                          "key"
-                        ],
-                        "type": "object"
-                      },
-                      {
-                        "properties": {
-                          "kind": {
-                            "const": "related",
-                            "type": "string"
-                          },
-                          "path": {
-                            "minLength": 1,
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "kind",
-                          "path"
-                        ],
-                        "type": "object"
-                      }
-                    ]
-                  },
-                  "value": {}
-                },
-                "required": [
-                  "ref",
-                  "op"
-                ],
-                "type": "object"
-              },
-              "maxItems": 6,
-              "minItems": 1,
-              "type": "array"
-            },
-            "mode": {
-              "enum": [
-                "any",
-                "none"
-              ],
-              "type": "string"
-            }
-          },
-          "required": [
-            "mode",
-            "filters"
-          ],
-          "type": "object"
-        },
-        "maxItems": 4,
-        "type": "array"
-      },
-      "filters": {
-        "default": [],
-        "items": {
-          "properties": {
-            "op": {
-              "enum": [
-                "eq",
-                "neq",
-                "gt",
-                "gte",
-                "lt",
-                "lte",
-                "contains",
-                "starts_with",
-                "in",
-                "not_in",
-                "has_any",
-                "in_period",
-                "is_null",
-                "is_not_null"
-              ],
-              "type": "string"
-            },
-            "ref": {
-              "oneOf": [
-                {
-                  "properties": {
-                    "field": {
-                      "minLength": 1,
-                      "type": "string"
-                    },
-                    "kind": {
-                      "const": "field",
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "kind",
-                    "field"
-                  ],
-                  "type": "object"
-                },
-                {
-                  "properties": {
-                    "key": {
-                      "minLength": 1,
-                      "type": "string"
-                    },
-                    "kind": {
-                      "const": "custom",
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "kind",
-                    "key"
-                  ],
-                  "type": "object"
-                },
-                {
-                  "properties": {
-                    "kind": {
-                      "const": "related",
-                      "type": "string"
-                    },
-                    "path": {
-                      "minLength": 1,
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "kind",
-                    "path"
-                  ],
-                  "type": "object"
-                }
-              ]
-            },
-            "value": {}
-          },
-          "required": [
-            "ref",
-            "op"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "group_by": {
-        "anyOf": [
-          {
-            "properties": {
-              "bucket": {
-                "enum": [
-                  "day",
-                  "week",
-                  "month",
-                  "quarter",
-                  "year"
-                ],
-                "type": "string"
-              },
-              "ref": {
-                "oneOf": [
-                  {
-                    "properties": {
-                      "field": {
-                        "minLength": 1,
-                        "type": "string"
-                      },
-                      "kind": {
-                        "const": "field",
-                        "type": "string"
-                      }
-                    },
-                    "required": [
-                      "kind",
-                      "field"
-                    ],
-                    "type": "object"
-                  },
-                  {
-                    "properties": {
-                      "key": {
-                        "minLength": 1,
-                        "type": "string"
-                      },
-                      "kind": {
-                        "const": "custom",
-                        "type": "string"
-                      }
-                    },
-                    "required": [
-                      "kind",
-                      "key"
-                    ],
-                    "type": "object"
-                  },
-                  {
-                    "properties": {
-                      "kind": {
-                        "const": "related",
-                        "type": "string"
-                      },
-                      "path": {
-                        "minLength": 1,
-                        "type": "string"
-                      }
-                    },
-                    "required": [
-                      "kind",
-                      "path"
-                    ],
-                    "type": "object"
-                  }
-                ]
-              }
-            },
-            "required": [
-              "ref"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "group_by_secondary": {
-        "anyOf": [
-          {
-            "properties": {
-              "bucket": {
-                "enum": [
-                  "day",
-                  "week",
-                  "month",
-                  "quarter",
-                  "year"
-                ],
-                "type": "string"
-              },
-              "ref": {
-                "oneOf": [
-                  {
-                    "properties": {
-                      "field": {
-                        "minLength": 1,
-                        "type": "string"
-                      },
-                      "kind": {
-                        "const": "field",
-                        "type": "string"
-                      }
-                    },
-                    "required": [
-                      "kind",
-                      "field"
-                    ],
-                    "type": "object"
-                  },
-                  {
-                    "properties": {
-                      "key": {
-                        "minLength": 1,
-                        "type": "string"
-                      },
-                      "kind": {
-                        "const": "custom",
-                        "type": "string"
-                      }
-                    },
-                    "required": [
-                      "kind",
-                      "key"
-                    ],
-                    "type": "object"
-                  },
-                  {
-                    "properties": {
-                      "kind": {
-                        "const": "related",
-                        "type": "string"
-                      },
-                      "path": {
-                        "minLength": 1,
-                        "type": "string"
-                      }
-                    },
-                    "required": [
-                      "kind",
-                      "path"
-                    ],
-                    "type": "object"
-                  }
-                ]
-              }
-            },
-            "required": [
-              "ref"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "limit": {
-        "default": 1000,
-        "exclusiveMinimum": 0,
-        "maximum": 9007199254740991,
-        "type": "integer"
-      },
-      "object": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "related_filters": {
-        "items": {
-          "properties": {
-            "filters": {
-              "default": [],
-              "items": {
-                "properties": {
-                  "op": {
-                    "enum": [
-                      "eq",
-                      "neq",
-                      "gt",
-                      "gte",
-                      "lt",
-                      "lte",
-                      "contains",
-                      "starts_with",
-                      "in",
-                      "not_in",
-                      "has_any",
-                      "in_period",
-                      "is_null",
-                      "is_not_null"
-                    ],
-                    "type": "string"
-                  },
-                  "ref": {
-                    "oneOf": [
-                      {
-                        "properties": {
-                          "field": {
-                            "minLength": 1,
-                            "type": "string"
-                          },
-                          "kind": {
-                            "const": "field",
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "kind",
-                          "field"
-                        ],
-                        "type": "object"
-                      },
-                      {
-                        "properties": {
-                          "key": {
-                            "minLength": 1,
-                            "type": "string"
-                          },
-                          "kind": {
-                            "const": "custom",
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "kind",
-                          "key"
-                        ],
-                        "type": "object"
-                      },
-                      {
-                        "properties": {
-                          "kind": {
-                            "const": "related",
-                            "type": "string"
-                          },
-                          "path": {
-                            "minLength": 1,
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "kind",
-                          "path"
-                        ],
-                        "type": "object"
-                      }
-                    ]
-                  },
-                  "value": {}
-                },
-                "required": [
-                  "ref",
-                  "op"
-                ],
-                "type": "object"
-              },
-              "maxItems": 5,
-              "type": "array"
-            },
-            "mode": {
-              "enum": [
-                "with",
-                "without"
-              ],
-              "type": "string"
-            },
-            "related": {
-              "minLength": 1,
-              "type": "string"
-            }
-          },
-          "required": [
-            "related",
-            "mode"
-          ],
-          "type": "object"
-        },
-        "maxItems": 3,
-        "type": "array"
-      },
-      "show_share": {
-        "type": "boolean"
-      },
-      "sort": {
-        "anyOf": [
-          {
-            "properties": {
-              "dir": {
-                "enum": [
-                  "asc",
-                  "desc"
-                ],
-                "type": "string"
-              },
-              "ref": {
-                "minLength": 1,
-                "type": "string"
-              }
-            },
-            "required": [
-              "ref",
-              "dir"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "version": {
-        "const": 1,
-        "type": "number"
-      },
-      "viz": {
-        "enum": [
-          "table",
-          "bar",
-          "stat",
-          "trend",
-          "donut",
-          "board",
-          "matrix",
-          "funnel",
-          "column",
-          "area"
-        ],
-        "type": "string"
-      }
-    },
-    "required": [
-      "version",
-      "object"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "properties": {
+      "dashboard_filters": {
+        "properties": {
+          "filters": {
+            "items": {
+              "properties": {
+                "object": {
+                  "maxLength": 100,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "op": {
+                  "enum": [
+                    "eq",
+                    "gte",
+                    "lte",
+                    "in_period"
+                  ],
+                  "type": "string"
+                },
+                "ref": {
+                  "oneOf": [
+                    {
+                      "properties": {
+                        "field": {
+                          "minLength": 1,
+                          "type": "string"
+                        },
+                        "kind": {
+                          "const": "field",
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "kind",
+                        "field"
+                      ],
+                      "type": "object"
+                    },
+                    {
+                      "properties": {
+                        "key": {
+                          "minLength": 1,
+                          "type": "string"
+                        },
+                        "kind": {
+                          "const": "custom",
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "kind",
+                        "key"
+                      ],
+                      "type": "object"
+                    },
+                    {
+                      "properties": {
+                        "kind": {
+                          "const": "related",
+                          "type": "string"
+                        },
+                        "path": {
+                          "minLength": 1,
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "kind",
+                        "path"
+                      ],
+                      "type": "object"
+                    }
+                  ]
+                },
+                "value": {
+                  "maxLength": 1000,
+                  "minLength": 1,
+                  "type": "string"
+                }
+              },
+              "required": [
+                "ref",
+                "value"
+              ],
+              "type": "object"
+            },
+            "maxItems": 6,
+            "type": "array"
+          },
+          "period": {
+            "properties": {
+              "default": {
+                "enum": [
+                  "today",
+                  "yesterday",
+                  "this_week",
+                  "last_7_days",
+                  "next_7_days",
+                  "last_30_days",
+                  "next_30_days",
+                  "last_90_days",
+                  "this_month",
+                  "last_month",
+                  "this_quarter",
+                  "this_year",
+                  "overdue",
+                  "upcoming"
+                ],
+                "type": "string"
+              },
+              "enabled": {
+                "const": true,
+                "type": "boolean"
+              }
+            },
+            "required": [
+              "enabled"
+            ],
+            "type": "object"
+          }
+        },
+        "type": "object"
+      },
+      "kind": {
+        "const": "composition",
+        "type": "string"
+      },
+      "layout": {
+        "properties": {
+          "rows": {
+            "items": {
+              "properties": {
+                "widgetIds": {
+                  "items": {
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "minItems": 1,
+                  "type": "array"
+                }
+              },
+              "required": [
+                "widgetIds"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          }
+        },
+        "required": [
+          "rows"
+        ],
+        "type": "object"
+      },
+      "title": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "version": {
+        "const": 1,
+        "type": "number"
+      },
+      "widgets": {
+        "items": {
+          "properties": {
+            "id": {
+              "minLength": 1,
+              "type": "string"
+            },
+            "pin_window": {
+              "type": "boolean"
+            },
+            "source_view_id": {
+              "minLength": 1,
+              "type": "string"
+            },
+            "spec": {
+              "description": "Inline ReportSpec for this panel — the same shape as the ReportSpec variant of this definition."
+            },
+            "title": {
+              "minLength": 1,
+              "type": "string"
+            },
+            "viz": {
+              "enum": [
+                "table",
+                "bar",
+                "stat",
+                "trend",
+                "donut",
+                "board",
+                "matrix",
+                "funnel",
+                "column",
+                "area"
+              ],
+              "type": "string"
+            },
+            "width": {
+              "anyOf": [
+                {
+                  "const": 2,
+                  "type": "number"
+                },
+                {
+                  "const": 3,
+                  "type": "number"
+                },
+                {
+                  "const": 4,
+                  "type": "number"
+                },
+                {
+                  "const": 6,
+                  "type": "number"
+                }
+              ]
+            }
+          },
+          "required": [
+            "id",
+            "title"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "version",
+      "kind",
+      "layout",
+      "widgets"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "kind": {
+        "const": "segment",
+        "type": "string"
+      },
+      "object": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "state": {
+        "properties": {
+          "conds": {
+            "items": {
+              "properties": {
+                "fieldKey": {
+                  "maxLength": 80,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "op": {
+                  "enum": [
+                    "contains",
+                    "eq",
+                    "is_null",
+                    "gte",
+                    "lt",
+                    "between",
+                    "in_next",
+                    "in_last",
+                    "overdue",
+                    "in",
+                    "not_in"
+                  ],
+                  "type": "string"
+                },
+                "value": {
+                  "anyOf": [
+                    {
+                      "maxLength": 120,
+                      "type": "string"
+                    },
+                    {
+                      "items": {
+                        "maxLength": 120,
+                        "minLength": 1,
+                        "type": "string"
+                      },
+                      "maxItems": 50,
+                      "minItems": 1,
+                      "type": "array"
+                    }
+                  ]
+                }
+              },
+              "required": [
+                "fieldKey",
+                "op"
+              ],
+              "type": "object"
+            },
+            "maxItems": 8,
+            "type": "array"
+          },
+          "filters": {
+            "additionalProperties": {
+              "maxLength": 120,
+              "minLength": 1,
+              "type": "string"
+            },
+            "propertyNames": {
+              "maxLength": 80,
+              "minLength": 1,
+              "type": "string"
+            },
+            "type": "object"
+          },
+          "match": {
+            "enum": [
+              "all",
+              "any"
+            ],
+            "type": "string"
+          },
+          "q": {
+            "maxLength": 200,
+            "minLength": 1,
+            "type": "string"
+          },
+          "seg": {
+            "maxLength": 64,
+            "minLength": 1,
+            "type": "string"
+          },
+          "sort": {
+            "maxLength": 64,
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "version": {
+        "const": 1,
+        "type": "number"
+      }
+    },
+    "required": [
+      "version",
+      "kind",
+      "object",
+      "state"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "aggregations": {
+        "default": [],
+        "items": {
+          "properties": {
+            "alias": {
+              "minLength": 1,
+              "type": "string"
+            },
+            "fn": {
+              "enum": [
+                "count",
+                "count_distinct",
+                "sum",
+                "avg",
+                "min",
+                "max"
+              ],
+              "type": "string"
+            },
+            "ref": {
+              "oneOf": [
+                {
+                  "properties": {
+                    "field": {
+                      "minLength": 1,
+                      "type": "string"
+                    },
+                    "kind": {
+                      "const": "field",
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "kind",
+                    "field"
+                  ],
+                  "type": "object"
+                },
+                {
+                  "properties": {
+                    "key": {
+                      "minLength": 1,
+                      "type": "string"
+                    },
+                    "kind": {
+                      "const": "custom",
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "kind",
+                    "key"
+                  ],
+                  "type": "object"
+                },
+                {
+                  "properties": {
+                    "kind": {
+                      "const": "related",
+                      "type": "string"
+                    },
+                    "path": {
+                      "minLength": 1,
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "kind",
+                    "path"
+                  ],
+                  "type": "object"
+                }
+              ]
+            },
+            "where": {
+              "items": {
+                "properties": {
+                  "op": {
+                    "enum": [
+                      "eq",
+                      "neq",
+                      "gt",
+                      "gte",
+                      "lt",
+                      "lte",
+                      "contains",
+                      "starts_with",
+                      "in",
+                      "not_in",
+                      "has_any",
+                      "in_period",
+                      "is_null",
+                      "is_not_null"
+                    ],
+                    "type": "string"
+                  },
+                  "ref": {
+                    "oneOf": [
+                      {
+                        "properties": {
+                          "field": {
+                            "minLength": 1,
+                            "type": "string"
+                          },
+                          "kind": {
+                            "const": "field",
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "kind",
+                          "field"
+                        ],
+                        "type": "object"
+                      },
+                      {
+                        "properties": {
+                          "key": {
+                            "minLength": 1,
+                            "type": "string"
+                          },
+                          "kind": {
+                            "const": "custom",
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "kind",
+                          "key"
+                        ],
+                        "type": "object"
+                      },
+                      {
+                        "properties": {
+                          "kind": {
+                            "const": "related",
+                            "type": "string"
+                          },
+                          "path": {
+                            "minLength": 1,
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "kind",
+                          "path"
+                        ],
+                        "type": "object"
+                      }
+                    ]
+                  },
+                  "value": {}
+                },
+                "required": [
+                  "ref",
+                  "op"
+                ],
+                "type": "object"
+              },
+              "maxItems": 3,
+              "type": "array"
+            }
+          },
+          "required": [
+            "fn",
+            "alias"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "board_group": {
+        "oneOf": [
+          {
+            "properties": {
+              "field": {
+                "minLength": 1,
+                "type": "string"
+              },
+              "kind": {
+                "const": "field",
+                "type": "string"
+              }
+            },
+            "required": [
+              "kind",
+              "field"
+            ],
+            "type": "object"
+          },
+          {
+            "properties": {
+              "key": {
+                "minLength": 1,
+                "type": "string"
+              },
+              "kind": {
+                "const": "custom",
+                "type": "string"
+              }
+            },
+            "required": [
+              "kind",
+              "key"
+            ],
+            "type": "object"
+          },
+          {
+            "properties": {
+              "kind": {
+                "const": "related",
+                "type": "string"
+              },
+              "path": {
+                "minLength": 1,
+                "type": "string"
+              }
+            },
+            "required": [
+              "kind",
+              "path"
+            ],
+            "type": "object"
+          }
+        ]
+      },
+      "columns": {
+        "default": [],
+        "items": {
+          "oneOf": [
+            {
+              "properties": {
+                "field": {
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "kind": {
+                  "const": "field",
+                  "type": "string"
+                }
+              },
+              "required": [
+                "kind",
+                "field"
+              ],
+              "type": "object"
+            },
+            {
+              "properties": {
+                "key": {
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "kind": {
+                  "const": "custom",
+                  "type": "string"
+                }
+              },
+              "required": [
+                "kind",
+                "key"
+              ],
+              "type": "object"
+            },
+            {
+              "properties": {
+                "kind": {
+                  "const": "related",
+                  "type": "string"
+                },
+                "path": {
+                  "minLength": 1,
+                  "type": "string"
+                }
+              },
+              "required": [
+                "kind",
+                "path"
+              ],
+              "type": "object"
+            }
+          ]
+        },
+        "type": "array"
+      },
+      "compare": {
+        "enum": [
+          "previous_period"
+        ],
+        "type": "string"
+      },
+      "derived": {
+        "items": {
+          "properties": {
+            "alias": {
+              "minLength": 1,
+              "type": "string"
+            },
+            "denominator": {
+              "minLength": 1,
+              "type": "string"
+            },
+            "format": {
+              "enum": [
+                "percent",
+                "number"
+              ],
+              "type": "string"
+            },
+            "kind": {
+              "const": "ratio",
+              "type": "string"
+            },
+            "numerator": {
+              "minLength": 1,
+              "type": "string"
+            }
+          },
+          "required": [
+            "kind",
+            "numerator",
+            "denominator",
+            "alias"
+          ],
+          "type": "object"
+        },
+        "maxItems": 3,
+        "type": "array"
+      },
+      "filter_groups": {
+        "items": {
+          "properties": {
+            "filters": {
+              "items": {
+                "properties": {
+                  "op": {
+                    "enum": [
+                      "eq",
+                      "neq",
+                      "gt",
+                      "gte",
+                      "lt",
+                      "lte",
+                      "contains",
+                      "starts_with",
+                      "in",
+                      "not_in",
+                      "has_any",
+                      "in_period",
+                      "is_null",
+                      "is_not_null"
+                    ],
+                    "type": "string"
+                  },
+                  "ref": {
+                    "oneOf": [
+                      {
+                        "properties": {
+                          "field": {
+                            "minLength": 1,
+                            "type": "string"
+                          },
+                          "kind": {
+                            "const": "field",
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "kind",
+                          "field"
+                        ],
+                        "type": "object"
+                      },
+                      {
+                        "properties": {
+                          "key": {
+                            "minLength": 1,
+                            "type": "string"
+                          },
+                          "kind": {
+                            "const": "custom",
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "kind",
+                          "key"
+                        ],
+                        "type": "object"
+                      },
+                      {
+                        "properties": {
+                          "kind": {
+                            "const": "related",
+                            "type": "string"
+                          },
+                          "path": {
+                            "minLength": 1,
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "kind",
+                          "path"
+                        ],
+                        "type": "object"
+                      }
+                    ]
+                  },
+                  "value": {}
+                },
+                "required": [
+                  "ref",
+                  "op"
+                ],
+                "type": "object"
+              },
+              "maxItems": 6,
+              "minItems": 1,
+              "type": "array"
+            },
+            "mode": {
+              "enum": [
+                "any",
+                "none"
+              ],
+              "type": "string"
+            }
+          },
+          "required": [
+            "mode",
+            "filters"
+          ],
+          "type": "object"
+        },
+        "maxItems": 4,
+        "type": "array"
+      },
+      "filters": {
+        "default": [],
+        "items": {
+          "properties": {
+            "op": {
+              "enum": [
+                "eq",
+                "neq",
+                "gt",
+                "gte",
+                "lt",
+                "lte",
+                "contains",
+                "starts_with",
+                "in",
+                "not_in",
+                "has_any",
+                "in_period",
+                "is_null",
+                "is_not_null"
+              ],
+              "type": "string"
+            },
+            "ref": {
+              "oneOf": [
+                {
+                  "properties": {
+                    "field": {
+                      "minLength": 1,
+                      "type": "string"
+                    },
+                    "kind": {
+                      "const": "field",
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "kind",
+                    "field"
+                  ],
+                  "type": "object"
+                },
+                {
+                  "properties": {
+                    "key": {
+                      "minLength": 1,
+                      "type": "string"
+                    },
+                    "kind": {
+                      "const": "custom",
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "kind",
+                    "key"
+                  ],
+                  "type": "object"
+                },
+                {
+                  "properties": {
+                    "kind": {
+                      "const": "related",
+                      "type": "string"
+                    },
+                    "path": {
+                      "minLength": 1,
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "kind",
+                    "path"
+                  ],
+                  "type": "object"
+                }
+              ]
+            },
+            "value": {}
+          },
+          "required": [
+            "ref",
+            "op"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "group_by": {
+        "anyOf": [
+          {
+            "properties": {
+              "bucket": {
+                "enum": [
+                  "day",
+                  "week",
+                  "month",
+                  "quarter",
+                  "year"
+                ],
+                "type": "string"
+              },
+              "ref": {
+                "oneOf": [
+                  {
+                    "properties": {
+                      "field": {
+                        "minLength": 1,
+                        "type": "string"
+                      },
+                      "kind": {
+                        "const": "field",
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "kind",
+                      "field"
+                    ],
+                    "type": "object"
+                  },
+                  {
+                    "properties": {
+                      "key": {
+                        "minLength": 1,
+                        "type": "string"
+                      },
+                      "kind": {
+                        "const": "custom",
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "kind",
+                      "key"
+                    ],
+                    "type": "object"
+                  },
+                  {
+                    "properties": {
+                      "kind": {
+                        "const": "related",
+                        "type": "string"
+                      },
+                      "path": {
+                        "minLength": 1,
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "kind",
+                      "path"
+                    ],
+                    "type": "object"
+                  }
+                ]
+              }
+            },
+            "required": [
+              "ref"
+            ],
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "group_by_secondary": {
+        "anyOf": [
+          {
+            "properties": {
+              "bucket": {
+                "enum": [
+                  "day",
+                  "week",
+                  "month",
+                  "quarter",
+                  "year"
+                ],
+                "type": "string"
+              },
+              "ref": {
+                "oneOf": [
+                  {
+                    "properties": {
+                      "field": {
+                        "minLength": 1,
+                        "type": "string"
+                      },
+                      "kind": {
+                        "const": "field",
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "kind",
+                      "field"
+                    ],
+                    "type": "object"
+                  },
+                  {
+                    "properties": {
+                      "key": {
+                        "minLength": 1,
+                        "type": "string"
+                      },
+                      "kind": {
+                        "const": "custom",
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "kind",
+                      "key"
+                    ],
+                    "type": "object"
+                  },
+                  {
+                    "properties": {
+                      "kind": {
+                        "const": "related",
+                        "type": "string"
+                      },
+                      "path": {
+                        "minLength": 1,
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "kind",
+                      "path"
+                    ],
+                    "type": "object"
+                  }
+                ]
+              }
+            },
+            "required": [
+              "ref"
+            ],
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "limit": {
+        "default": 1000,
+        "exclusiveMinimum": 0,
+        "maximum": 9007199254740991,
+        "type": "integer"
+      },
+      "object": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "related_filters": {
+        "items": {
+          "properties": {
+            "filters": {
+              "default": [],
+              "items": {
+                "properties": {
+                  "op": {
+                    "enum": [
+                      "eq",
+                      "neq",
+                      "gt",
+                      "gte",
+                      "lt",
+                      "lte",
+                      "contains",
+                      "starts_with",
+                      "in",
+                      "not_in",
+                      "has_any",
+                      "in_period",
+                      "is_null",
+                      "is_not_null"
+                    ],
+                    "type": "string"
+                  },
+                  "ref": {
+                    "oneOf": [
+                      {
+                        "properties": {
+                          "field": {
+                            "minLength": 1,
+                            "type": "string"
+                          },
+                          "kind": {
+                            "const": "field",
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "kind",
+                          "field"
+                        ],
+                        "type": "object"
+                      },
+                      {
+                        "properties": {
+                          "key": {
+                            "minLength": 1,
+                            "type": "string"
+                          },
+                          "kind": {
+                            "const": "custom",
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "kind",
+                          "key"
+                        ],
+                        "type": "object"
+                      },
+                      {
+                        "properties": {
+                          "kind": {
+                            "const": "related",
+                            "type": "string"
+                          },
+                          "path": {
+                            "minLength": 1,
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "kind",
+                          "path"
+                        ],
+                        "type": "object"
+                      }
+                    ]
+                  },
+                  "value": {}
+                },
+                "required": [
+                  "ref",
+                  "op"
+                ],
+                "type": "object"
+              },
+              "maxItems": 5,
+              "type": "array"
+            },
+            "mode": {
+              "enum": [
+                "with",
+                "without"
+              ],
+              "type": "string"
+            },
+            "related": {
+              "minLength": 1,
+              "type": "string"
+            }
+          },
+          "required": [
+            "related",
+            "mode"
+          ],
+          "type": "object"
+        },
+        "maxItems": 3,
+        "type": "array"
+      },
+      "show_share": {
+        "type": "boolean"
+      },
+      "sort": {
+        "anyOf": [
+          {
+            "properties": {
+              "dir": {
+                "enum": [
+                  "asc",
+                  "desc"
+                ],
+                "type": "string"
+              },
+              "ref": {
+                "minLength": 1,
+                "type": "string"
+              }
+            },
+            "required": [
+              "ref",
+              "dir"
+            ],
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "version": {
+        "const": 1,
+        "type": "number"
+      },
+      "viz": {
+        "enum": [
+          "table",
+          "bar",
+          "stat",
+          "trend",
+          "donut",
+          "board",
+          "matrix",
+          "funnel",
+          "column",
+          "area"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "version",
+      "object"
+    ],
+    "type": "object"
+  }
+]

Changed1 schema field changedOct 7, 2026

changedInput schema / properties / suggested_name / description

Previous value: -"A name to seed the card's \"Save as view\" button, echoed as suggested_name; only meaningful with an inline definition (this call saves nothing)."New value: +"A name for a later save, echoed as suggested_name; only meaningful with an inline definition (this call saves nothing)."

First observedOct 6, 2026

TDQS

A4.9/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnly/destructive, but the description adds substantial non-structured context: the call shows the user nothing, saves nothing, report_id wins over definition and source_view_id is ignored with report_id, zero-row results must be reported, definition errors must be fixed, and View saves must not be claimed before success. The money-in-minor-units / no-FX warning is a real behavioral constraint an agent would otherwise get wrong.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with the preview-vs-display distinction, and every sentence carries load (save path, currency rule, example, recipes link). It is dense and packs invocation, correctness and workflow guidance into one block, which slightly hurts scannability, but there is no filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a tool with a 3-variant union schema and an output schema, the description covers everything an agent needs: how to invoke, precedence rules, that nothing is displayed or saved, the follow-up tool for display and for save, currency semantics, and the pointer to capable://guide/reports for recipes.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is already 100%, yet the description still adds meaning beyond the schema: the report_id-vs-definition precedence, the panel rule that each has EITHER an inline spec OR source_view_id, ref object syntax ({kind:"related",path:"account.name"}), in_period being a closed set, and fixed ranges using gte + lt/lte. That is genuine disambiguation of the most error-prone parts of a large union type.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Opens with a specific verb+resource and immediately pins the scope: 'Preview analysis/dashboard data for your own reading; shows the user nothing.' It explicitly distinguishes itself from the nearest sibling (show_report) for display and search_records for plain lists, so an agent can route without opening a schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives explicit when-to-use ('Counts, sums or trends'), names alternatives with their selecting conditions ('use search_records for plain record lists', 'To display it, call show_report', 'To save, call create_record with object_type:"report"'). When-not guidance is present and concrete.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Capable tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?