AdsAgent — Meta Ads MCP

insights_read_breakdowns

Read country, placement, age, gender, OS, or hourly Meta metrics for one product_ref or product_name and date window. Returns stored rows and full-scope totals; a cache miss may queue a bounded pull and return task_ref. Poll tasks_get_status, then repeat the read with identical filters. Automatic pulls use the existing daily quota; ad delivery is unchanged

Input Schema

Name	Required	Default
`level`	No
`limit`	No
`ad_ids`	No
`cursor`	No
`rollup`	No	dimension
`date_to`	No
`date_from`	No
`product_ref`	No
`product_name`	No
`breakdown_type`	No
`conversion_event`	No

Output Schema

Name	Required	Description	Default
`message`	No
`retryable`	No
`support_ref`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 23, 2026
- removedInput schema / properties / connection_context
```
Removed value: -{
-  "pattern": "^mctx_v1_[0-9a-f]{64}$",
-  "type": "string"
-}
```

Changed3 schema fields changedOct 22, 2026

removedOutput schema / $defs

Removed value: -{
-  "s0": {
-    "additionalProperties": {
-      "properties": {
-        "complete": {
-          "type": "boolean"
-        },
-        "excluded_rows": {
-          "type": "integer"
-        },
-        "reason": {
-          "type": [
-            "string",
-            "null"
-          ]
-        }
-      },
-      "type": "object"
-    },
-    "type": "object"
-  },
-  "s7": {
-    "properties": {
-      "as_of": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "conversion_value": {
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "conversions": {
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "status": {
-        "type": "string"
-      }
-    },
-    "type": "object"
-  }
-}

changedOutput schema / else / anyOf

Previous value: -[
-  {
-    "properties": {
-      "ad_ids": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "cache_hint": {
-        "properties": {
-          "message": {
-            "type": "string"
-          },
-          "recommended_next_tool": {
-            "type": "string"
-          },
-          "status": {
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "complete": {
-        "type": "boolean"
-      },
-      "count": {
-        "type": "integer"
-      },
-      "dimension_row_count": {
-        "type": "integer"
-      },
-      "items": {
-        "items": {
-          "properties": {
-            "ad_account_id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "ad_id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "ad_name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "adset_id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "adset_name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "bid_amount": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "bid_strategy": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "breakdown_key": {
-              "type": "string"
-            },
-            "breakdown_type": {
-              "type": "string"
-            },
-            "budget_level": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "campaign_id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "campaign_name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "campaign_row_count": {
-              "type": "integer"
-            },
-            "clicks": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "configured_status": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "conversion_value": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "conversions": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "cpa": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "cpc": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "cpc_usd": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "cpm": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "cpm_usd": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "ctr": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "currency": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "daily_budget": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "data_as_of_date": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "date": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "date_from": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "date_start": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "date_stop": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "date_to": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "delivery_issue_codes": {
-              "items": {
-                "type": "string"
-              },
-              "type": "array"
-            },
-            "delivery_status": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "effective_status": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "entity_id": {
-              "type": "string"
-            },
-            "entity_name": {
-              "type": "string"
-            },
-            "event_metrics": {
-              "additionalProperties": {
-                "properties": {
-                  "cost_usd": {
-                    "type": "number"
-                  },
-                  "count": {
-                    "type": "number"
-                  },
-                  "cvr_clicks": {
-                    "type": "number"
-                  }
-                },
-                "type": "object"
-              },
-              "type": "object"
-            },
-            "funnel": {
-              "additionalProperties": {
-                "type": "number"
-              },
-              "type": "object"
-            },
-            "historical_result": {
-              "$ref": "#/$defs/s7"
-            },
-            "id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "impressions": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "level": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "lifetime_budget": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "metric_completeness": {
-              "$ref": "#/$defs/s0"
-            },
-            "money_unit": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "optimization_goal": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "primary_event_count": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "primary_event_cpa_usd": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "primary_event_name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "product_type": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "reach": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "result_segments": {
-              "items": {
-                "properties": {
-                  "adset_specs": {
-                    "items": {
-                      "items": {
-                        "properties": {
-                          "event_type": {
-                            "type": "string"
-                          },
-                          "window_days": {
-                            "type": "integer"
-                          }
-                        },
-                        "type": "object"
-                      },
-                      "type": [
-                        "array",
-                        "null"
-                      ]
-                    },
-                    "type": "array"
-                  },
-                  "as_of": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
-                  },
-                  "count": {
-                    "type": [
-                      "number",
-                      "null"
-                    ]
-                  },
-                  "count_rows": {
-                    "type": "integer"
-                  },
-                  "currency": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
-                  },
-                  "indicator": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
-                  },
-                  "mixed_adset_specs": {
-                    "type": "boolean"
-                  },
-                  "reasons": {
-                    "items": {
-                      "type": "string"
-                    },
-                    "type": "array"
-                  },
-                  "rows": {
-                    "type": "integer"
-                  },
-                  "value": {
-                    "type": [
-                      "number",
-                      "null"
-                    ]
-                  },
-                  "value_currency": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
-                  },
-                  "value_rows": {
-                    "type": "integer"
-                  }
-                },
-                "type": "object"
-              },
-              "type": "array"
-            },
-            "roas": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "rollup": {
-              "type": "string"
-            },
-            "source_observed_at": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "spend": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "spend_usd": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "status": {
-              "type": [
-                "string",
-                "null"
-              ]
-            }
-          },
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "meta": {
-        "properties": {
-          "cache_hit": {
-            "type": "boolean"
-          },
-          "coalesced": {
-            "type": "boolean"
-          },
-          "complete": {
-            "type": "boolean"
-          },
-          "data_as_of_date": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "data_freshness": {
-            "properties": {
-              "interval_min": {
-                "type": "integer"
-              },
-              "label": {
-                "type": "string"
-              },
-              "last_pull_failed_account_count": {
-                "type": [
-                  "integer",
-                  "null"
-                ]
-              },
-              "last_pull_scope": {
-                "const": "workspace"
-              },
-              "last_pull_status": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "last_pulled_at": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "max_staleness_min": {
-                "type": "integer"
-              },
-              "server_now_utc": {
-                "type": "string"
-              },
-              "staleness_seconds": {
-                "type": [
-                  "integer",
-                  "null"
-                ]
-              }
-            },
-            "type": "object"
-          },
-          "duration_ms": {
-            "type": "integer"
-          },
-          "failed": {
-            "type": "integer"
-          },
-          "freshness_warnings": {
-            "items": {
-              "properties": {
-                "account_count": {
-                  "type": "integer"
-                },
-                "code": {
-                  "type": "string"
-                },
-                "dispersion_seconds": {
-                  "type": "integer"
-                },
-                "last_pull_failed_account_count": {
-                  "type": [
-                    "integer",
-                    "null"
-                  ]
-                },
-                "last_pull_status": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "message": {
-                  "type": "string"
-                },
-                "metrics_source_observed_at": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "newest_source_observed_at": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "observed_account_count": {
-                  "type": "integer"
-                },
-                "oldest_source_observed_at": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                }
-              },
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "has_more": {
-            "type": "boolean"
-          },
-          "item_count": {
-            "type": "integer"
-          },
-          "limitations": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "metric_completeness": {
-            "$ref": "#/$defs/s0"
-          },
-          "metrics_source_observed_at": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "missing_scopes": {
-            "items": {
-              "properties": {
-                "index": {
-                  "type": "integer"
-                },
-                "status": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "index",
-                "status"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "next_cursor": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "page": {
-            "type": "integer"
-          },
-          "page_size": {
-            "type": "integer"
-          },
-          "refresh_reused": {
-            "type": "boolean"
-          },
-          "returned_count": {
-            "type": "integer"
-          },
-          "scope_count": {
-            "type": "integer"
-          },
-          "source": {
-            "type": "string"
-          },
-          "source_observed_at": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "source_row_count": {
-            "type": "integer"
-          },
-          "source_truncated": {
-            "type": "boolean"
-          },
-          "source_watermark": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "succeeded": {
-            "type": "integer"
-          },
-          "total_count": {
-            "type": [
-              "integer",
-              "null"
-            ]
-          },
-          "total_items": {
-            "type": "integer"
-          },
-          "total_pages": {
-            "type": "integer"
-          }
-        },
-        "type": "object"
-      },
-      "next_cursor": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "rollup": {
-        "type": "string"
-      },
-      "routing": {
-        "properties": {
-          "cache_coverage": {
-            "properties": {
-              "products": {
-                "additionalProperties": {
-                  "properties": {
-                    "complete": {
-                      "type": "boolean"
-                    },
-                    "has_more": {
-                      "type": "boolean"
-                    },
-                    "limitations": {
-                      "items": {
-                        "type": "string"
-                      },
-                      "type": "array"
-                    },
-                    "next_cursor": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "returned_count": {
-                      "type": "integer"
-                    },
-                    "source": {
-                      "type": "string"
-                    },
-                    "source_observed_at": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "source_watermark": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "total_count": {
-                      "type": [
-                        "integer",
-                        "null"
-                      ]
-                    }
-                  },
-                  "type": "object"
-                },
-                "type": "object"
-              },
-              "status": {
-                "type": "string"
-              }
-            },
-            "type": "object"
-          },
-          "decision": {
-            "type": "string"
-          },
-          "pull_breakdowns": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "quota": {
-            "properties": {
-              "available": {
-                "type": "boolean"
-              },
-              "limit": {
-                "type": [
-                  "integer",
-                  "null"
-                ]
-              },
-              "operator_bypass": {
-                "type": "boolean"
-              },
-              "remaining": {
-                "type": "integer"
-              },
-              "used": {
-                "type": "integer"
-              }
-            },
-            "type": "object"
-          },
-          "reason": {
-            "type": "string"
-          },
-          "recommended_next_tool": {
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "stored_row_count": {
-        "type": [
-          "integer",
-          "null"
-        ]
-      },
-      "totals": {
-        "properties": {
-          "clicks": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "conversion_value": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "conversions": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "cpa": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "cpc": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "cpm": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "ctr": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "funnel": {
-            "additionalProperties": {
-              "type": "number"
-            },
-            "type": "object"
-          },
-          "historical_result": {
-            "$ref": "#/$defs/s7"
-          },
-          "impressions": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "metric_completeness": {
-            "$ref": "#/$defs/s0"
-          },
-          "reach": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "result_segments": {
-            "items": {
-              "properties": {
-                "adset_specs": {
-                  "items": {
-                    "items": {
-                      "properties": {
-                        "event_type": {
-                          "type": "string"
-                        },
-                        "window_days": {
-                          "type": "integer"
-                        }
-                      },
-                      "type": "object"
-                    },
-                    "type": [
-                      "array",
-                      "null"
-                    ]
-                  },
-                  "type": "array"
-                },
-                "as_of": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "count": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "count_rows": {
-                  "type": "integer"
-                },
-                "currency": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "indicator": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "mixed_adset_specs": {
-                  "type": "boolean"
-                },
-                "reasons": {
-                  "items": {
-                    "type": "string"
-                  },
-                  "type": "array"
-                },
-                "rows": {
-                  "type": "integer"
-                },
-                "value": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "value_currency": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "value_rows": {
-                  "type": "integer"
-                }
-              },
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "roas": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "spend": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "spend_usd": {
-            "type": [
-              "number",
-              "null"
-            ]
-          }
-        },
-        "type": "object"
-      },
-      "truncated": {
-        "type": "boolean"
-      }
-    },
-    "required": [
-      "items",
-      "count",
-      "truncated",
-      "rollup",
-      "meta",
-      "routing"
-    ]
-  },
-  {
-    "properties": {
-      "expires_at": {
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      },
-      "poll": {
-        "properties": {
-          "arguments": {
-            "properties": {
-              "product_ref": {
-                "type": "string"
-              },
-              "task_ref": {
-                "type": "string"
-              },
-              "template_name": {
-                "type": "string"
-              }
-            },
-            "type": "object"
-          },
-          "name": {
-            "type": "string"
-          },
-          "tool": {
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "poll_after_ms": {
-        "type": "integer"
-      },
-      "status": {
-        "const": "queued"
-      },
-      "submitted_new": {
-        "type": "boolean"
-      },
-      "task_ref": {
-        "type": "string"
-      },
-      "task_status": {
-        "type": "string"
-      },
-      "task_type": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "status",
-      "task_ref",
-      "task_status",
-      "poll_after_ms",
-      "expires_at",
-      "poll"
-    ]
-  }
-]New value: +[
+  {
+    "required": [
+      "count",
+      "items",
+      "meta",
+      "rollup",
+      "routing",
+      "truncated"
+    ]
+  },
+  {
+    "properties": {
+      "status": {
+        "const": "queued"
+      }
+    },
+    "required": [
+      "expires_at",
+      "poll",
+      "poll_after_ms",
+      "status",
+      "task_ref",
+      "task_status"
+    ]
+  }
+]

addedOutput schema / else / properties

Added value: +{
+  "ad_ids": {
+    "items": {
+      "type": "string"
+    },
+    "type": "array"
+  },
+  "cache_hint": {
+    "properties": {
+      "message": {
+        "type": "string"
+      },
+      "recommended_next_tool": {
+        "type": "string"
+      },
+      "status": {
+        "type": "string"
+      }
+    },
+    "type": "object"
+  },
+  "complete": {
+    "type": "boolean"
+  },
+  "count": {
+    "type": "integer"
+  },
+  "dimension_row_count": {
+    "type": "integer"
+  },
+  "expires_at": {
+    "type": "string"
+  },
+  "items": {
+    "items": {
+      "properties": {
+        "ad_account_id": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "ad_id": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "ad_name": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "adset_id": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "adset_name": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "bid_amount": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "bid_strategy": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "breakdown_key": {
+          "type": "string"
+        },
+        "breakdown_type": {
+          "type": "string"
+        },
+        "budget_level": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "campaign_id": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "campaign_name": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "campaign_row_count": {
+          "type": "integer"
+        },
+        "clicks": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "configured_status": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "conversion_value": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "conversions": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "cpa": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "cpc": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "cpc_usd": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "cpm": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "cpm_usd": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "ctr": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "currency": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "daily_budget": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "data_as_of_date": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "date": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "date_from": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "date_start": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "date_stop": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "date_to": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "delivery_issue_codes": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "delivery_status": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "effective_status": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "entity_id": {
+          "type": "string"
+        },
+        "entity_name": {
+          "type": "string"
+        },
+        "event_metrics": {
+          "additionalProperties": {
+            "properties": {
+              "cost_usd": {
+                "type": "number"
+              },
+              "count": {
+                "type": "number"
+              },
+              "cvr_clicks": {
+                "type": "number"
+              }
+            },
+            "type": "object"
+          },
+          "type": "object"
+        },
+        "funnel": {
+          "additionalProperties": {
+            "type": "number"
+          },
+          "type": "object"
+        },
+        "historical_result": {
+          "properties": {
+            "as_of": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "conversion_value": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "conversions": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "status": {
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "id": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "impressions": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "level": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "lifetime_budget": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "metric_completeness": {
+          "additionalProperties": {
+            "properties": {
+              "complete": {
+                "type": "boolean"
+              },
+              "excluded_rows": {
+                "type": "integer"
+              },
+              "reason": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              }
+            },
+            "type": "object"
+          },
+          "type": "object"
+        },
+        "money_unit": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "name": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "optimization_goal": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "primary_event_count": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "primary_event_cpa_usd": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "primary_event_name": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "product_type": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "reach": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "result_segments": {
+          "items": {
+            "properties": {
+              "adset_specs": {
+                "items": {
+                  "items": {
+                    "properties": {
+                      "event_type": {
+                        "type": "string"
+                      },
+                      "window_days": {
+                        "type": "integer"
+                      }
+                    },
+                    "type": "object"
+                  },
+                  "type": [
+                    "array",
+                    "null"
+                  ]
+                },
+                "type": "array"
+              },
+              "as_of": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "count": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "count_rows": {
+                "type": "integer"
+              },
+              "currency": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "indicator": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "mixed_adset_specs": {
+                "type": "boolean"
+              },
+              "reasons": {
+                "items": {
+                  "type": "string"
+                },
+                "type": "array"
+              },
+              "rows": {
+                "type": "integer"
+              },
+              "value": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "value_currency": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "value_rows": {
+                "type": "integer"
+              }
+            },
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "roas": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "rollup": {
+          "type": "string"
+        },
+        "source_observed_at": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "spend": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "spend_usd": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "status": {
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      },
+      "type": "object"
+    },
+    "type": "array"
+  },
+  "message": {
+    "type": "string"
+  },
+  "meta": {
+    "properties": {
+      "cache_hit": {
+        "type": "boolean"
+      },
+      "coalesced": {
+        "type": "boolean"
+      },
+      "complete": {
+        "type": "boolean"
+      },
+      "data_as_of_date": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "data_freshness": {
+        "properties": {
+          "interval_min": {
+            "type": "integer"
+          },
+          "label": {
+            "type": "string"
+          },
+          "last_pull_failed_account_count": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "last_pull_scope": {
+            "const": "workspace"
+          },
+          "last_pull_status": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "last_pulled_at": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "max_staleness_min": {
+            "type": "integer"
+          },
+          "server_now_utc": {
+            "type": "string"
+          },
+          "staleness_seconds": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          }
+        },
+        "type": "object"
+      },
+      "duration_ms": {
+        "type": "integer"
+      },
+      "failed": {
+        "type": "integer"
+      },
+      "freshness_warnings": {
+        "items": {
+          "properties": {
+            "account_count": {
+              "type": "integer"
+            },
+            "code": {
+              "type": "string"
+            },
+            "dispersion_seconds": {
+              "type": "integer"
+            },
+            "last_pull_failed_account_count": {
+              "type": [
+                "integer",
+                "null"
+              ]
+            },
+            "last_pull_status": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "message": {
+              "type": "string"
+            },
+            "metrics_source_observed_at": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "newest_source_observed_at": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "observed_account_count": {
+              "type": "integer"
+            },
+            "oldest_source_observed_at": {
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "has_more": {
+        "type": "boolean"
+      },
+      "item_count": {
+        "type": "integer"
+      },
+      "limitations": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "metric_completeness": {
+        "additionalProperties": {
+          "properties": {
+            "complete": {
+              "type": "boolean"
+            },
+            "excluded_rows": {
+              "type": "integer"
+            },
+            "reason": {
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          },
+          "type": "object"
+        },
+        "type": "object"
+      },
+      "metrics_source_observed_at": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "missing_scopes": {
+        "items": {
+          "properties": {
+            "index": {
+              "type": "integer"
+            },
+            "status": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "index",
+            "status"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "next_cursor": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "page": {
+        "type": "integer"
+      },
+      "page_size": {
+        "type": "integer"
+      },
+      "refresh_reused": {
+        "type": "boolean"
+      },
+      "returned_count": {
+        "type": "integer"
+      },
+      "scope_count": {
+        "type": "integer"
+      },
+      "source": {
+        "type": "string"
+      },
+      "source_observed_at": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "source_row_count": {
+        "type": "integer"
+      },
+      "source_truncated": {
+        "type": "boolean"
+      },
+      "source_watermark": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "succeeded": {
+        "type": "integer"
+      },
+      "total_count": {
+        "type": [
+          "integer",
+          "null"
+        ]
+      },
+      "total_items": {
+        "type": "integer"
+      },
+      "total_pages": {
+        "type": "integer"
+      }
+    },
+    "type": "object"
+  },
+  "next_cursor": {
+    "type": [
+      "string",
+      "null"
+    ]
+  },
+  "poll": {
+    "properties": {
+      "arguments": {
+        "properties": {
+          "product_ref": {
+            "type": "string"
+          },
+          "task_ref": {
+            "type": "string"
+          },
+          "template_name": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "name": {
+        "type": "string"
+      },
+      "tool": {
+        "type": "string"
+      }
+    },
+    "type": "object"
+  },
+  "poll_after_ms": {
+    "type": "integer"
+  },
+  "rollup": {
+    "type": "string"
+  },
+  "routing": {
+    "properties": {
+      "cache_coverage": {
+        "properties": {
+          "products": {
+            "additionalProperties": {
+              "properties": {
+                "complete": {
+                  "type": "boolean"
+                },
+                "has_more": {
+                  "type": "boolean"
+                },
+                "limitations": {
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
+                },
+                "next_cursor": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "returned_count": {
+                  "type": "integer"
+                },
+                "source": {
+                  "type": "string"
+                },
+                "source_observed_at": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "source_watermark": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "total_count": {
+                  "type": [
+                    "integer",
+                    "null"
+                  ]
+                }
+              },
+              "type": "object"
+            },
+            "type": "object"
+          },
+          "status": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "decision": {
+        "type": "string"
+      },
+      "pull_breakdowns": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "quota": {
+        "properties": {
+          "available": {
+            "type": "boolean"
+          },
+          "limit": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "operator_bypass": {
+            "type": "boolean"
+          },
+          "remaining": {
+            "type": "integer"
+          },
+          "used": {
+            "type": "integer"
+          }
+        },
+        "type": "object"
+      },
+      "reason": {
+        "type": "string"
+      },
+      "recommended_next_tool": {
+        "type": "string"
+      }
+    },
+    "type": "object"
+  },
+  "status": {
+    "const": "queued"
+  },
+  "stored_row_count": {
+    "type": [
+      "integer",
+      "null"
+    ]
+  },
+  "submitted_new": {
+    "type": "boolean"
+  },
+  "task_ref": {
+    "type": "string"
+  },
+  "task_status": {
+    "type": "string"
+  },
+  "task_type": {
+    "type": "string"
+  },
+  "totals": {
+    "properties": {
+      "clicks": {
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "conversion_value": {
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "conversions": {
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "cpa": {
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "cpc": {
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "cpm": {
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "ctr": {
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "funnel": {
+        "additionalProperties": {
+          "type": "number"
+        },
+        "type": "object"
+      },
+      "historical_result": {
+        "properties": {
+          "as_of": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "conversion_value": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "conversions": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "status": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "impressions": {
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "metric_completeness": {
+        "additionalProperties": {
+          "properties": {
+            "complete": {
+              "type": "boolean"
+            },
+            "excluded_rows": {
+              "type": "integer"
+            },
+            "reason": {
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          },
+          "type": "object"
+        },
+        "type": "object"
+      },
+      "reach": {
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "result_segments": {
+        "items": {
+          "properties": {
+            "adset_specs": {
+              "items": {
+                "items": {
+                  "properties": {
+                    "event_type": {
+                      "type": "string"
+                    },
+                    "window_days": {
+                      "type": "integer"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": [
+                  "array",
+                  "null"
+                ]
+              },
+              "type": "array"
+            },
+            "as_of": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "count": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "count_rows": {
+              "type": "integer"
+            },
+            "currency": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "indicator": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "mixed_adset_specs": {
+              "type": "boolean"
+            },
+            "reasons": {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            "rows": {
+              "type": "integer"
+            },
+            "value": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "value_currency": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "value_rows": {
+              "type": "integer"
+            }
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "roas": {
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "spend": {
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "spend_usd": {
+        "type": [
+          "number",
+          "null"
+        ]
+      }
+    },
+    "type": "object"
+  },
+  "truncated": {
+    "type": "boolean"
+  }
+}

Changed6 schema fields changedOct 15, 2026
- addedOutput schema / then / properties / category
```
Added value: +{
+  "type": "string"
+}
```
- addedOutput schema / then / properties / expected
```
Added value: +{
+  "type": "boolean"
+}
```
- addedOutput schema / then / properties / failure_kind
```
Added value: +{
+  "type": "string"
+}
```
- addedOutput schema / then / properties / responsibility_hint
```
Added value: +{
+  "type": "string"
+}
```
- addedOutput schema / then / properties / route
```
Added value: +{
+  "type": "string"
+}
```
- addedOutput schema / then / properties / user_visible
```
Added value: +{
+  "type": "boolean"
+}
```
Changed1 schema field changedOct 13, 2026
- addedInput schema / properties / connection_context
```
Added value: +{
+  "pattern": "^mctx_v1_[0-9a-f]{64}$",
+  "type": "string"
+}
```

Changed3 schema fields changedOct 11, 2026

removedOutput schema / $defs / s4

Removed value: -{
-  "properties": {
-    "as_of": {
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "conversion_value": {
-      "type": [
-        "number",
-        "null"
-      ]
-    },
-    "conversions": {
-      "type": [
-        "number",
-        "null"
-      ]
-    },
-    "status": {
-      "type": "string"
-    }
-  },
-  "type": "object"
-}

addedOutput schema / $defs / s7

Added value: +{
+  "properties": {
+    "as_of": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "conversion_value": {
+      "type": [
+        "number",
+        "null"
+      ]
+    },
+    "conversions": {
+      "type": [
+        "number",
+        "null"
+      ]
+    },
+    "status": {
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

changedOutput schema / else / anyOf

Previous value: -[
-  {
-    "properties": {
-      "ad_ids": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "cache_hint": {
-        "properties": {
-          "message": {
-            "type": "string"
-          },
-          "recommended_next_tool": {
-            "type": "string"
-          },
-          "status": {
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "complete": {
-        "type": "boolean"
-      },
-      "count": {
-        "type": "integer"
-      },
-      "dimension_row_count": {
-        "type": "integer"
-      },
-      "items": {
-        "items": {
-          "properties": {
-            "ad_account_id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "ad_id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "ad_name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "adset_id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "adset_name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "bid_amount": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "bid_strategy": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "breakdown_key": {
-              "type": "string"
-            },
-            "breakdown_type": {
-              "type": "string"
-            },
-            "budget_level": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "campaign_id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "campaign_name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "campaign_row_count": {
-              "type": "integer"
-            },
-            "clicks": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "configured_status": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "conversion_value": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "conversions": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "cpa": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "cpc": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "cpc_usd": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "cpm": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "cpm_usd": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "ctr": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "currency": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "daily_budget": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "data_as_of_date": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "date": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "date_from": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "date_start": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "date_stop": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "date_to": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "delivery_issue_codes": {
-              "items": {
-                "type": "string"
-              },
-              "type": "array"
-            },
-            "delivery_status": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "effective_status": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "entity_id": {
-              "type": "string"
-            },
-            "entity_name": {
-              "type": "string"
-            },
-            "event_metrics": {
-              "additionalProperties": {
-                "properties": {
-                  "cost_usd": {
-                    "type": "number"
-                  },
-                  "count": {
-                    "type": "number"
-                  },
-                  "cvr_clicks": {
-                    "type": "number"
-                  }
-                },
-                "type": "object"
-              },
-              "type": "object"
-            },
-            "funnel": {
-              "additionalProperties": {
-                "type": "number"
-              },
-              "type": "object"
-            },
-            "historical_result": {
-              "$ref": "#/$defs/s4"
-            },
-            "id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "impressions": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "level": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "lifetime_budget": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "metric_completeness": {
-              "$ref": "#/$defs/s0"
-            },
-            "money_unit": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "optimization_goal": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "primary_event_count": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "primary_event_cpa_usd": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "primary_event_name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "product_type": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "reach": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "result_segments": {
-              "items": {
-                "properties": {
-                  "as_of": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
-                  },
-                  "count": {
-                    "type": [
-                      "number",
-                      "null"
-                    ]
-                  },
-                  "count_rows": {
-                    "type": "integer"
-                  },
-                  "currency": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
-                  },
-                  "indicator": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
-                  },
-                  "reasons": {
-                    "items": {
-                      "type": "string"
-                    },
-                    "type": "array"
-                  },
-                  "rows": {
-                    "type": "integer"
-                  },
-                  "value": {
-                    "type": [
-                      "number",
-                      "null"
-                    ]
-                  },
-                  "value_currency": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
-                  },
-                  "value_rows": {
-                    "type": "integer"
-                  }
-                },
-                "type": "object"
-              },
-              "type": "array"
-            },
-            "roas": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "rollup": {
-              "type": "string"
-            },
-            "source_observed_at": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "spend": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "spend_usd": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "status": {
-              "type": [
-                "string",
-                "null"
-              ]
-            }
-          },
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "meta": {
-        "properties": {
-          "cache_hit": {
-            "type": "boolean"
-          },
-          "coalesced": {
-            "type": "boolean"
-          },
-          "complete": {
-            "type": "boolean"
-          },
-          "data_as_of_date": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "data_freshness": {
-            "properties": {
-              "interval_min": {
-                "type": "integer"
-              },
-              "label": {
-                "type": "string"
-              },
-              "last_pull_failed_account_count": {
-                "type": [
-                  "integer",
-                  "null"
-                ]
-              },
-              "last_pull_scope": {
-                "const": "workspace"
-              },
-              "last_pull_status": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "last_pulled_at": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "max_staleness_min": {
-                "type": "integer"
-              },
-              "server_now_utc": {
-                "type": "string"
-              },
-              "staleness_seconds": {
-                "type": [
-                  "integer",
-                  "null"
-                ]
-              }
-            },
-            "type": "object"
-          },
-          "duration_ms": {
-            "type": "integer"
-          },
-          "failed": {
-            "type": "integer"
-          },
-          "freshness_warnings": {
-            "items": {
-              "properties": {
-                "account_count": {
-                  "type": "integer"
-                },
-                "code": {
-                  "type": "string"
-                },
-                "dispersion_seconds": {
-                  "type": "integer"
-                },
-                "last_pull_failed_account_count": {
-                  "type": [
-                    "integer",
-                    "null"
-                  ]
-                },
-                "last_pull_status": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "message": {
-                  "type": "string"
-                },
-                "metrics_source_observed_at": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "newest_source_observed_at": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "observed_account_count": {
-                  "type": "integer"
-                },
-                "oldest_source_observed_at": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                }
-              },
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "has_more": {
-            "type": "boolean"
-          },
-          "item_count": {
-            "type": "integer"
-          },
-          "limitations": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "metric_completeness": {
-            "$ref": "#/$defs/s0"
-          },
-          "metrics_source_observed_at": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "missing_scopes": {
-            "items": {
-              "properties": {
-                "index": {
-                  "type": "integer"
-                },
-                "status": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "index",
-                "status"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "next_cursor": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "page": {
-            "type": "integer"
-          },
-          "page_size": {
-            "type": "integer"
-          },
-          "refresh_reused": {
-            "type": "boolean"
-          },
-          "returned_count": {
-            "type": "integer"
-          },
-          "scope_count": {
-            "type": "integer"
-          },
-          "source": {
-            "type": "string"
-          },
-          "source_observed_at": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "source_row_count": {
-            "type": "integer"
-          },
-          "source_truncated": {
-            "type": "boolean"
-          },
-          "source_watermark": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "succeeded": {
-            "type": "integer"
-          },
-          "total_count": {
-            "type": [
-              "integer",
-              "null"
-            ]
-          },
-          "total_items": {
-            "type": "integer"
-          },
-          "total_pages": {
-            "type": "integer"
-          }
-        },
-        "type": "object"
-      },
-      "next_cursor": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "rollup": {
-        "type": "string"
-      },
-      "routing": {
-        "properties": {
-          "cache_coverage": {
-            "properties": {
-              "products": {
-                "additionalProperties": {
-                  "properties": {
-                    "complete": {
-                      "type": "boolean"
-                    },
-                    "has_more": {
-                      "type": "boolean"
-                    },
-                    "limitations": {
-                      "items": {
-                        "type": "string"
-                      },
-                      "type": "array"
-                    },
-                    "next_cursor": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "returned_count": {
-                      "type": "integer"
-                    },
-                    "source": {
-                      "type": "string"
-                    },
-                    "source_observed_at": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "source_watermark": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "total_count": {
-                      "type": [
-                        "integer",
-                        "null"
-                      ]
-                    }
-                  },
-                  "type": "object"
-                },
-                "type": "object"
-              },
-              "status": {
-                "type": "string"
-              }
-            },
-            "type": "object"
-          },
-          "decision": {
-            "type": "string"
-          },
-          "pull_breakdowns": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "quota": {
-            "properties": {
-              "available": {
-                "type": "boolean"
-              },
-              "limit": {
-                "type": [
-                  "integer",
-                  "null"
-                ]
-              },
-              "operator_bypass": {
-                "type": "boolean"
-              },
-              "remaining": {
-                "type": "integer"
-              },
-              "used": {
-                "type": "integer"
-              }
-            },
-            "type": "object"
-          },
-          "reason": {
-            "type": "string"
-          },
-          "recommended_next_tool": {
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "stored_row_count": {
-        "type": [
-          "integer",
-          "null"
-        ]
-      },
-      "totals": {
-        "properties": {
-          "clicks": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "conversion_value": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "conversions": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "cpa": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "cpc": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "cpm": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "ctr": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "funnel": {
-            "additionalProperties": {
-              "type": "number"
-            },
-            "type": "object"
-          },
-          "historical_result": {
-            "$ref": "#/$defs/s4"
-          },
-          "impressions": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "metric_completeness": {
-            "$ref": "#/$defs/s0"
-          },
-          "reach": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "result_segments": {
-            "items": {
-              "properties": {
-                "as_of": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "count": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "count_rows": {
-                  "type": "integer"
-                },
-                "currency": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "indicator": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "reasons": {
-                  "items": {
-                    "type": "string"
-                  },
-                  "type": "array"
-                },
-                "rows": {
-                  "type": "integer"
-                },
-                "value": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "value_currency": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "value_rows": {
-                  "type": "integer"
-                }
-              },
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "roas": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "spend": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "spend_usd": {
-            "type": [
-              "number",
-              "null"
-            ]
-          }
-        },
-        "type": "object"
-      },
-      "truncated": {
-        "type": "boolean"
-      }
-    },
-    "required": [
-      "items",
-      "count",
-      "truncated",
-      "rollup",
-      "meta",
-      "routing"
-    ]
-  },
-  {
-    "properties": {
-      "expires_at": {
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      },
-      "poll": {
-        "properties": {
-          "arguments": {
-            "properties": {
-              "product_ref": {
-                "type": "string"
-              },
-              "task_ref": {
-                "type": "string"
-              },
-              "template_name": {
-                "type": "string"
-              }
-            },
-            "type": "object"
-          },
-          "name": {
-            "type": "string"
-          },
-          "tool": {
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "poll_after_ms": {
-        "type": "integer"
-      },
-      "status": {
-        "const": "queued"
-      },
-      "submitted_new": {
-        "type": "boolean"
-      },
-      "task_ref": {
-        "type": "string"
-      },
-      "task_status": {
-        "type": "string"
-      },
-      "task_type": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "status",
-      "task_ref",
-      "task_status",
-      "poll_after_ms",
-      "expires_at",
-      "poll"
-    ]
-  }
-]New value: +[
+  {
+    "properties": {
+      "ad_ids": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "cache_hint": {
+        "properties": {
+          "message": {
+            "type": "string"
+          },
+          "recommended_next_tool": {
+            "type": "string"
+          },
+          "status": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "complete": {
+        "type": "boolean"
+      },
+      "count": {
+        "type": "integer"
+      },
+      "dimension_row_count": {
+        "type": "integer"
+      },
+      "items": {
+        "items": {
+          "properties": {
+            "ad_account_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "ad_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "ad_name": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "adset_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "adset_name": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "bid_amount": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "bid_strategy": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "breakdown_key": {
+              "type": "string"
+            },
+            "breakdown_type": {
+              "type": "string"
+            },
+            "budget_level": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "campaign_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "campaign_name": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "campaign_row_count": {
+              "type": "integer"
+            },
+            "clicks": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "configured_status": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "conversion_value": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "conversions": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "cpa": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "cpc": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "cpc_usd": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "cpm": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "cpm_usd": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "ctr": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "currency": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "daily_budget": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "data_as_of_date": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "date": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "date_from": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "date_start": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "date_stop": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "date_to": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "delivery_issue_codes": {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            "delivery_status": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "effective_status": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "entity_id": {
+              "type": "string"
+            },
+            "entity_name": {
+              "type": "string"
+            },
+            "event_metrics": {
+              "additionalProperties": {
+                "properties": {
+                  "cost_usd": {
+                    "type": "number"
+                  },
+                  "count": {
+                    "type": "number"
+                  },
+                  "cvr_clicks": {
+                    "type": "number"
+                  }
+                },
+                "type": "object"
+              },
+              "type": "object"
+            },
+            "funnel": {
+              "additionalProperties": {
+                "type": "number"
+              },
+              "type": "object"
+            },
+            "historical_result": {
+              "$ref": "#/$defs/s7"
+            },
+            "id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "impressions": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "level": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "lifetime_budget": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "metric_completeness": {
+              "$ref": "#/$defs/s0"
+            },
+            "money_unit": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "name": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "optimization_goal": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "primary_event_count": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "primary_event_cpa_usd": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "primary_event_name": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "product_type": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "reach": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "result_segments": {
+              "items": {
+                "properties": {
+                  "adset_specs": {
+                    "items": {
+                      "items": {
+                        "properties": {
+                          "event_type": {
+                            "type": "string"
+                          },
+                          "window_days": {
+                            "type": "integer"
+                          }
+                        },
+                        "type": "object"
+                      },
+                      "type": [
+                        "array",
+                        "null"
+                      ]
+                    },
+                    "type": "array"
+                  },
+                  "as_of": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "count": {
+                    "type": [
+                      "number",
+                      "null"
+                    ]
+                  },
+                  "count_rows": {
+                    "type": "integer"
+                  },
+                  "currency": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "indicator": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "mixed_adset_specs": {
+                    "type": "boolean"
+                  },
+                  "reasons": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  "rows": {
+                    "type": "integer"
+                  },
+                  "value": {
+                    "type": [
+                      "number",
+                      "null"
+                    ]
+                  },
+                  "value_currency": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "value_rows": {
+                    "type": "integer"
+                  }
+                },
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "roas": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "rollup": {
+              "type": "string"
+            },
+            "source_observed_at": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "spend": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "spend_usd": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "status": {
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "meta": {
+        "properties": {
+          "cache_hit": {
+            "type": "boolean"
+          },
+          "coalesced": {
+            "type": "boolean"
+          },
+          "complete": {
+            "type": "boolean"
+          },
+          "data_as_of_date": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "data_freshness": {
+            "properties": {
+              "interval_min": {
+                "type": "integer"
+              },
+              "label": {
+                "type": "string"
+              },
+              "last_pull_failed_account_count": {
+                "type": [
+                  "integer",
+                  "null"
+                ]
+              },
+              "last_pull_scope": {
+                "const": "workspace"
+              },
+              "last_pull_status": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "last_pulled_at": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "max_staleness_min": {
+                "type": "integer"
+              },
+              "server_now_utc": {
+                "type": "string"
+              },
+              "staleness_seconds": {
+                "type": [
+                  "integer",
+                  "null"
+                ]
+              }
+            },
+            "type": "object"
+          },
+          "duration_ms": {
+            "type": "integer"
+          },
+          "failed": {
+            "type": "integer"
+          },
+          "freshness_warnings": {
+            "items": {
+              "properties": {
+                "account_count": {
+                  "type": "integer"
+                },
+                "code": {
+                  "type": "string"
+                },
+                "dispersion_seconds": {
+                  "type": "integer"
+                },
+                "last_pull_failed_account_count": {
+                  "type": [
+                    "integer",
+                    "null"
+                  ]
+                },
+                "last_pull_status": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "message": {
+                  "type": "string"
+                },
+                "metrics_source_observed_at": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "newest_source_observed_at": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "observed_account_count": {
+                  "type": "integer"
+                },
+                "oldest_source_observed_at": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "has_more": {
+            "type": "boolean"
+          },
+          "item_count": {
+            "type": "integer"
+          },
+          "limitations": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "metric_completeness": {
+            "$ref": "#/$defs/s0"
+          },
+          "metrics_source_observed_at": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "missing_scopes": {
+            "items": {
+              "properties": {
+                "index": {
+                  "type": "integer"
+                },
+                "status": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "index",
+                "status"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "next_cursor": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "page": {
+            "type": "integer"
+          },
+          "page_size": {
+            "type": "integer"
+          },
+          "refresh_reused": {
+            "type": "boolean"
+          },
+          "returned_count": {
+            "type": "integer"
+          },
+          "scope_count": {
+            "type": "integer"
+          },
+          "source": {
+            "type": "string"
+          },
+          "source_observed_at": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "source_row_count": {
+            "type": "integer"
+          },
+          "source_truncated": {
+            "type": "boolean"
+          },
+          "source_watermark": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "succeeded": {
+            "type": "integer"
+          },
+          "total_count": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "total_items": {
+            "type": "integer"
+          },
+          "total_pages": {
+            "type": "integer"
+          }
+        },
+        "type": "object"
+      },
+      "next_cursor": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "rollup": {
+        "type": "string"
+      },
+      "routing": {
+        "properties": {
+          "cache_coverage": {
+            "properties": {
+              "products": {
+                "additionalProperties": {
+                  "properties": {
+                    "complete": {
+                      "type": "boolean"
+                    },
+                    "has_more": {
+                      "type": "boolean"
+                    },
+                    "limitations": {
+                      "items": {
+                        "type": "string"
+                      },
+                      "type": "array"
+                    },
+                    "next_cursor": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "returned_count": {
+                      "type": "integer"
+                    },
+                    "source": {
+                      "type": "string"
+                    },
+                    "source_observed_at": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "source_watermark": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "total_count": {
+                      "type": [
+                        "integer",
+                        "null"
+                      ]
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "object"
+              },
+              "status": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "decision": {
+            "type": "string"
+          },
+          "pull_breakdowns": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "quota": {
+            "properties": {
+              "available": {
+                "type": "boolean"
+              },
+              "limit": {
+                "type": [
+                  "integer",
+                  "null"
+                ]
+              },
+              "operator_bypass": {
+                "type": "boolean"
+              },
+              "remaining": {
+                "type": "integer"
+              },
+              "used": {
+                "type": "integer"
+              }
+            },
+            "type": "object"
+          },
+          "reason": {
+            "type": "string"
+          },
+          "recommended_next_tool": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "stored_row_count": {
+        "type": [
+          "integer",
+          "null"
+        ]
+      },
+      "totals": {
+        "properties": {
+          "clicks": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "conversion_value": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "conversions": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "cpa": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "cpc": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "cpm": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "ctr": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "funnel": {
+            "additionalProperties": {
+              "type": "number"
+            },
+            "type": "object"
+          },
+          "historical_result": {
+            "$ref": "#/$defs/s7"
+          },
+          "impressions": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "metric_completeness": {
+            "$ref": "#/$defs/s0"
+          },
+          "reach": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "result_segments": {
+            "items": {
+              "properties": {
+                "adset_specs": {
+                  "items": {
+                    "items": {
+                      "properties": {
+                        "event_type": {
+                          "type": "string"
+                        },
+                        "window_days": {
+                          "type": "integer"
+                        }
+                      },
+                      "type": "object"
+                    },
+                    "type": [
+                      "array",
+                      "null"
+                    ]
+                  },
+                  "type": "array"
+                },
+                "as_of": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "count": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "count_rows": {
+                  "type": "integer"
+                },
+                "currency": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "indicator": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "mixed_adset_specs": {
+                  "type": "boolean"
+                },
+                "reasons": {
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
+                },
+                "rows": {
+                  "type": "integer"
+                },
+                "value": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "value_currency": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "value_rows": {
+                  "type": "integer"
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "roas": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "spend": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "spend_usd": {
+            "type": [
+              "number",
+              "null"
+            ]
+          }
+        },
+        "type": "object"
+      },
+      "truncated": {
+        "type": "boolean"
+      }
+    },
+    "required": [
+      "items",
+      "count",
+      "truncated",
+      "rollup",
+      "meta",
+      "routing"
+    ]
+  },
+  {
+    "properties": {
+      "expires_at": {
+        "type": "string"
+      },
+      "message": {
+        "type": "string"
+      },
+      "poll": {
+        "properties": {
+          "arguments": {
+            "properties": {
+              "product_ref": {
+                "type": "string"
+              },
+              "task_ref": {
+                "type": "string"
+              },
+              "template_name": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "name": {
+            "type": "string"
+          },
+          "tool": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "poll_after_ms": {
+        "type": "integer"
+      },
+      "status": {
+        "const": "queued"
+      },
+      "submitted_new": {
+        "type": "boolean"
+      },
+      "task_ref": {
+        "type": "string"
+      },
+      "task_status": {
+        "type": "string"
+      },
+      "task_type": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "status",
+      "task_ref",
+      "task_status",
+      "poll_after_ms",
+      "expires_at",
+      "poll"
+    ]
+  }
+]

Changed2 schema fields changedOct 8, 2026

addedOutput schema / $defs

Added value: +{
+  "s0": {
+    "additionalProperties": {
+      "properties": {
+        "complete": {
+          "type": "boolean"
+        },
+        "excluded_rows": {
+          "type": "integer"
+        },
+        "reason": {
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      },
+      "type": "object"
+    },
+    "type": "object"
+  },
+  "s4": {
+    "properties": {
+      "as_of": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "conversion_value": {
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "conversions": {
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "status": {
+        "type": "string"
+      }
+    },
+    "type": "object"
+  }
+}

changedOutput schema / else / anyOf

Previous value: -[
-  {
-    "properties": {
-      "ad_ids": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "cache_hint": {
-        "properties": {
-          "message": {
-            "type": "string"
-          },
-          "recommended_next_tool": {
-            "type": "string"
-          },
-          "status": {
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "complete": {
-        "type": "boolean"
-      },
-      "count": {
-        "type": "integer"
-      },
-      "dimension_row_count": {
-        "type": "integer"
-      },
-      "items": {
-        "items": {
-          "properties": {
-            "ad_account_id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "ad_id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "ad_name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "adset_id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "adset_name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "bid_amount": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "bid_strategy": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "breakdown_key": {
-              "type": "string"
-            },
-            "breakdown_type": {
-              "type": "string"
-            },
-            "budget_level": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "campaign_id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "campaign_name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "campaign_row_count": {
-              "type": "integer"
-            },
-            "clicks": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "configured_status": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "conversion_value": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "conversions": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "cpa": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "cpc": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "cpc_usd": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "cpm": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "cpm_usd": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "ctr": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "currency": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "daily_budget": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "data_as_of_date": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "date": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "date_from": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "date_start": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "date_stop": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "date_to": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "delivery_issue_codes": {
-              "items": {
-                "type": "string"
-              },
-              "type": "array"
-            },
-            "delivery_status": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "effective_status": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "entity_id": {
-              "type": "string"
-            },
-            "entity_name": {
-              "type": "string"
-            },
-            "event_metrics": {
-              "additionalProperties": {
-                "properties": {
-                  "cost_usd": {
-                    "type": "number"
-                  },
-                  "count": {
-                    "type": "number"
-                  },
-                  "cvr_clicks": {
-                    "type": "number"
-                  }
-                },
-                "type": "object"
-              },
-              "type": "object"
-            },
-            "funnel": {
-              "additionalProperties": {
-                "type": "number"
-              },
-              "type": "object"
-            },
-            "id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "impressions": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "level": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "lifetime_budget": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "money_unit": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "optimization_goal": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "primary_event_count": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "primary_event_cpa_usd": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "primary_event_name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "product_type": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "reach": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "roas": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "rollup": {
-              "type": "string"
-            },
-            "source_observed_at": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "spend": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "spend_usd": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "status": {
-              "type": [
-                "string",
-                "null"
-              ]
-            }
-          },
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "meta": {
-        "properties": {
-          "cache_hit": {
-            "type": "boolean"
-          },
-          "coalesced": {
-            "type": "boolean"
-          },
-          "complete": {
-            "type": "boolean"
-          },
-          "data_as_of_date": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "data_freshness": {
-            "properties": {
-              "interval_min": {
-                "type": "integer"
-              },
-              "label": {
-                "type": "string"
-              },
-              "last_pull_failed_account_count": {
-                "type": [
-                  "integer",
-                  "null"
-                ]
-              },
-              "last_pull_scope": {
-                "const": "workspace"
-              },
-              "last_pull_status": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "last_pulled_at": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "max_staleness_min": {
-                "type": "integer"
-              },
-              "server_now_utc": {
-                "type": "string"
-              },
-              "staleness_seconds": {
-                "type": [
-                  "integer",
-                  "null"
-                ]
-              }
-            },
-            "type": "object"
-          },
-          "duration_ms": {
-            "type": "integer"
-          },
-          "failed": {
-            "type": "integer"
-          },
-          "freshness_warnings": {
-            "items": {
-              "properties": {
-                "account_count": {
-                  "type": "integer"
-                },
-                "code": {
-                  "type": "string"
-                },
-                "dispersion_seconds": {
-                  "type": "integer"
-                },
-                "last_pull_failed_account_count": {
-                  "type": [
-                    "integer",
-                    "null"
-                  ]
-                },
-                "last_pull_status": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "message": {
-                  "type": "string"
-                },
-                "metrics_source_observed_at": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "newest_source_observed_at": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "observed_account_count": {
-                  "type": "integer"
-                },
-                "oldest_source_observed_at": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                }
-              },
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "has_more": {
-            "type": "boolean"
-          },
-          "item_count": {
-            "type": "integer"
-          },
-          "limitations": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "metrics_source_observed_at": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "missing_scopes": {
-            "items": {
-              "properties": {
-                "index": {
-                  "type": "integer"
-                },
-                "status": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "index",
-                "status"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "next_cursor": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "page": {
-            "type": "integer"
-          },
-          "page_size": {
-            "type": "integer"
-          },
-          "refresh_reused": {
-            "type": "boolean"
-          },
-          "returned_count": {
-            "type": "integer"
-          },
-          "scope_count": {
-            "type": "integer"
-          },
-          "source": {
-            "type": "string"
-          },
-          "source_observed_at": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "source_row_count": {
-            "type": "integer"
-          },
-          "source_truncated": {
-            "type": "boolean"
-          },
-          "source_watermark": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "succeeded": {
-            "type": "integer"
-          },
-          "total_count": {
-            "type": [
-              "integer",
-              "null"
-            ]
-          },
-          "total_items": {
-            "type": "integer"
-          },
-          "total_pages": {
-            "type": "integer"
-          }
-        },
-        "type": "object"
-      },
-      "next_cursor": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "rollup": {
-        "type": "string"
-      },
-      "routing": {
-        "properties": {
-          "cache_coverage": {
-            "properties": {
-              "products": {
-                "additionalProperties": {
-                  "properties": {
-                    "complete": {
-                      "type": "boolean"
-                    },
-                    "has_more": {
-                      "type": "boolean"
-                    },
-                    "limitations": {
-                      "items": {
-                        "type": "string"
-                      },
-                      "type": "array"
-                    },
-                    "next_cursor": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "returned_count": {
-                      "type": "integer"
-                    },
-                    "source": {
-                      "type": "string"
-                    },
-                    "source_observed_at": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "source_watermark": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "total_count": {
-                      "type": [
-                        "integer",
-                        "null"
-                      ]
-                    }
-                  },
-                  "type": "object"
-                },
-                "type": "object"
-              },
-              "status": {
-                "type": "string"
-              }
-            },
-            "type": "object"
-          },
-          "decision": {
-            "type": "string"
-          },
-          "pull_breakdowns": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "quota": {
-            "properties": {
-              "available": {
-                "type": "boolean"
-              },
-              "limit": {
-                "type": [
-                  "integer",
-                  "null"
-                ]
-              },
-              "operator_bypass": {
-                "type": "boolean"
-              },
-              "remaining": {
-                "type": "integer"
-              },
-              "used": {
-                "type": "integer"
-              }
-            },
-            "type": "object"
-          },
-          "reason": {
-            "type": "string"
-          },
-          "recommended_next_tool": {
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "stored_row_count": {
-        "type": [
-          "integer",
-          "null"
-        ]
-      },
-      "totals": {
-        "properties": {
-          "clicks": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "conversion_value": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "conversions": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "cpa": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "cpc": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "cpm": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "ctr": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "funnel": {
-            "additionalProperties": {
-              "type": "number"
-            },
-            "type": "object"
-          },
-          "impressions": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "reach": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "roas": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "spend": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "spend_usd": {
-            "type": [
-              "number",
-              "null"
-            ]
-          }
-        },
-        "type": "object"
-      },
-      "truncated": {
-        "type": "boolean"
-      }
-    },
-    "required": [
-      "items",
-      "count",
-      "truncated",
-      "rollup",
-      "meta",
-      "routing"
-    ]
-  },
-  {
-    "properties": {
-      "expires_at": {
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      },
-      "poll": {
-        "properties": {
-          "arguments": {
-            "properties": {
-              "product_ref": {
-                "type": "string"
-              },
-              "task_ref": {
-                "type": "string"
-              },
-              "template_name": {
-                "type": "string"
-              }
-            },
-            "type": "object"
-          },
-          "name": {
-            "type": "string"
-          },
-          "tool": {
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "poll_after_ms": {
-        "type": "integer"
-      },
-      "status": {
-        "const": "queued"
-      },
-      "submitted_new": {
-        "type": "boolean"
-      },
-      "task_ref": {
-        "type": "string"
-      },
-      "task_status": {
-        "type": "string"
-      },
-      "task_type": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "status",
-      "task_ref",
-      "task_status",
-      "poll_after_ms",
-      "expires_at",
-      "poll"
-    ]
-  }
-]New value: +[
+  {
+    "properties": {
+      "ad_ids": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "cache_hint": {
+        "properties": {
+          "message": {
+            "type": "string"
+          },
+          "recommended_next_tool": {
+            "type": "string"
+          },
+          "status": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "complete": {
+        "type": "boolean"
+      },
+      "count": {
+        "type": "integer"
+      },
+      "dimension_row_count": {
+        "type": "integer"
+      },
+      "items": {
+        "items": {
+          "properties": {
+            "ad_account_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "ad_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "ad_name": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "adset_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "adset_name": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "bid_amount": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "bid_strategy": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "breakdown_key": {
+              "type": "string"
+            },
+            "breakdown_type": {
+              "type": "string"
+            },
+            "budget_level": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "campaign_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "campaign_name": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "campaign_row_count": {
+              "type": "integer"
+            },
+            "clicks": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "configured_status": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "conversion_value": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "conversions": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "cpa": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "cpc": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "cpc_usd": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "cpm": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "cpm_usd": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "ctr": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "currency": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "daily_budget": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "data_as_of_date": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "date": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "date_from": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "date_start": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "date_stop": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "date_to": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "delivery_issue_codes": {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            "delivery_status": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "effective_status": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "entity_id": {
+              "type": "string"
+            },
+            "entity_name": {
+              "type": "string"
+            },
+            "event_metrics": {
+              "additionalProperties": {
+                "properties": {
+                  "cost_usd": {
+                    "type": "number"
+                  },
+                  "count": {
+                    "type": "number"
+                  },
+                  "cvr_clicks": {
+                    "type": "number"
+                  }
+                },
+                "type": "object"
+              },
+              "type": "object"
+            },
+            "funnel": {
+              "additionalProperties": {
+                "type": "number"
+              },
+              "type": "object"
+            },
+            "historical_result": {
+              "$ref": "#/$defs/s4"
+            },
+            "id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "impressions": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "level": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "lifetime_budget": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "metric_completeness": {
+              "$ref": "#/$defs/s0"
+            },
+            "money_unit": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "name": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "optimization_goal": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "primary_event_count": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "primary_event_cpa_usd": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "primary_event_name": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "product_type": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "reach": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "result_segments": {
+              "items": {
+                "properties": {
+                  "as_of": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "count": {
+                    "type": [
+                      "number",
+                      "null"
+                    ]
+                  },
+                  "count_rows": {
+                    "type": "integer"
+                  },
+                  "currency": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "indicator": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "reasons": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  "rows": {
+                    "type": "integer"
+                  },
+                  "value": {
+                    "type": [
+                      "number",
+                      "null"
+                    ]
+                  },
+                  "value_currency": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "value_rows": {
+                    "type": "integer"
+                  }
+                },
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "roas": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "rollup": {
+              "type": "string"
+            },
+            "source_observed_at": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "spend": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "spend_usd": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "status": {
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "meta": {
+        "properties": {
+          "cache_hit": {
+            "type": "boolean"
+          },
+          "coalesced": {
+            "type": "boolean"
+          },
+          "complete": {
+            "type": "boolean"
+          },
+          "data_as_of_date": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "data_freshness": {
+            "properties": {
+              "interval_min": {
+                "type": "integer"
+              },
+              "label": {
+                "type": "string"
+              },
+              "last_pull_failed_account_count": {
+                "type": [
+                  "integer",
+                  "null"
+                ]
+              },
+              "last_pull_scope": {
+                "const": "workspace"
+              },
+              "last_pull_status": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "last_pulled_at": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "max_staleness_min": {
+                "type": "integer"
+              },
+              "server_now_utc": {
+                "type": "string"
+              },
+              "staleness_seconds": {
+                "type": [
+                  "integer",
+                  "null"
+                ]
+              }
+            },
+            "type": "object"
+          },
+          "duration_ms": {
+            "type": "integer"
+          },
+          "failed": {
+            "type": "integer"
+          },
+          "freshness_warnings": {
+            "items": {
+              "properties": {
+                "account_count": {
+                  "type": "integer"
+                },
+                "code": {
+                  "type": "string"
+                },
+                "dispersion_seconds": {
+                  "type": "integer"
+                },
+                "last_pull_failed_account_count": {
+                  "type": [
+                    "integer",
+                    "null"
+                  ]
+                },
+                "last_pull_status": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "message": {
+                  "type": "string"
+                },
+                "metrics_source_observed_at": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "newest_source_observed_at": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "observed_account_count": {
+                  "type": "integer"
+                },
+                "oldest_source_observed_at": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "has_more": {
+            "type": "boolean"
+          },
+          "item_count": {
+            "type": "integer"
+          },
+          "limitations": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "metric_completeness": {
+            "$ref": "#/$defs/s0"
+          },
+          "metrics_source_observed_at": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "missing_scopes": {
+            "items": {
+              "properties": {
+                "index": {
+                  "type": "integer"
+                },
+                "status": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "index",
+                "status"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "next_cursor": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "page": {
+            "type": "integer"
+          },
+          "page_size": {
+            "type": "integer"
+          },
+          "refresh_reused": {
+            "type": "boolean"
+          },
+          "returned_count": {
+            "type": "integer"
+          },
+          "scope_count": {
+            "type": "integer"
+          },
+          "source": {
+            "type": "string"
+          },
+          "source_observed_at": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "source_row_count": {
+            "type": "integer"
+          },
+          "source_truncated": {
+            "type": "boolean"
+          },
+          "source_watermark": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "succeeded": {
+            "type": "integer"
+          },
+          "total_count": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "total_items": {
+            "type": "integer"
+          },
+          "total_pages": {
+            "type": "integer"
+          }
+        },
+        "type": "object"
+      },
+      "next_cursor": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "rollup": {
+        "type": "string"
+      },
+      "routing": {
+        "properties": {
+          "cache_coverage": {
+            "properties": {
+              "products": {
+                "additionalProperties": {
+                  "properties": {
+                    "complete": {
+                      "type": "boolean"
+                    },
+                    "has_more": {
+                      "type": "boolean"
+                    },
+                    "limitations": {
+                      "items": {
+                        "type": "string"
+                      },
+                      "type": "array"
+                    },
+                    "next_cursor": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "returned_count": {
+                      "type": "integer"
+                    },
+                    "source": {
+                      "type": "string"
+                    },
+                    "source_observed_at": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "source_watermark": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "total_count": {
+                      "type": [
+                        "integer",
+                        "null"
+                      ]
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "object"
+              },
+              "status": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "decision": {
+            "type": "string"
+          },
+          "pull_breakdowns": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "quota": {
+            "properties": {
+              "available": {
+                "type": "boolean"
+              },
+              "limit": {
+                "type": [
+                  "integer",
+                  "null"
+                ]
+              },
+              "operator_bypass": {
+                "type": "boolean"
+              },
+              "remaining": {
+                "type": "integer"
+              },
+              "used": {
+                "type": "integer"
+              }
+            },
+            "type": "object"
+          },
+          "reason": {
+            "type": "string"
+          },
+          "recommended_next_tool": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "stored_row_count": {
+        "type": [
+          "integer",
+          "null"
+        ]
+      },
+      "totals": {
+        "properties": {
+          "clicks": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "conversion_value": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "conversions": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "cpa": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "cpc": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "cpm": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "ctr": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "funnel": {
+            "additionalProperties": {
+              "type": "number"
+            },
+            "type": "object"
+          },
+          "historical_result": {
+            "$ref": "#/$defs/s4"
+          },
+          "impressions": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "metric_completeness": {
+            "$ref": "#/$defs/s0"
+          },
+          "reach": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "result_segments": {
+            "items": {
+              "properties": {
+                "as_of": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "count": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "count_rows": {
+                  "type": "integer"
+                },
+                "currency": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "indicator": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "reasons": {
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
+                },
+                "rows": {
+                  "type": "integer"
+                },
+                "value": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "value_currency": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "value_rows": {
+                  "type": "integer"
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "roas": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "spend": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "spend_usd": {
+            "type": [
+              "number",
+              "null"
+            ]
+          }
+        },
+        "type": "object"
+      },
+      "truncated": {
+        "type": "boolean"
+      }
+    },
+    "required": [
+      "items",
+      "count",
+      "truncated",
+      "rollup",
+      "meta",
+      "routing"
+    ]
+  },
+  {
+    "properties": {
+      "expires_at": {
+        "type": "string"
+      },
+      "message": {
+        "type": "string"
+      },
+      "poll": {
+        "properties": {
+          "arguments": {
+            "properties": {
+              "product_ref": {
+                "type": "string"
+              },
+              "task_ref": {
+                "type": "string"
+              },
+              "template_name": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "name": {
+            "type": "string"
+          },
+          "tool": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "poll_after_ms": {
+        "type": "integer"
+      },
+      "status": {
+        "const": "queued"
+      },
+      "submitted_new": {
+        "type": "boolean"
+      },
+      "task_ref": {
+        "type": "string"
+      },
+      "task_status": {
+        "type": "string"
+      },
+      "task_type": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "status",
+      "task_ref",
+      "task_status",
+      "poll_after_ms",
+      "expires_at",
+      "poll"
+    ]
+  }
+]

Changed1 schema field changedSep 16, 2026
- addedInput schema / properties / conversion_event
```
Added value: +{
+  "type": "string"
+}
```

Changed4 schema fields changedSep 15, 2026

addedInput schema / properties / ad_ids

Added value: +{
+  "items": {
+    "type": "string"
+  },
+  "maxItems": 50,
+  "minItems": 1,
+  "type": "array"
+}

addedInput schema / properties / cursor
```
Added value: +{
+  "type": "string"
+}
```

changedInput schema / properties / rollup / enum

Previous value: -[
-  "dimension",
-  "campaign"
-]New value: +[
+  "dimension",
+  "campaign",
+  "ad"
+]

changedOutput schema / else / anyOf

Previous value: -[
-  {
-    "properties": {
-      "cache_hint": {
-        "properties": {
-          "message": {
-            "type": "string"
-          },
-          "recommended_next_tool": {
-            "type": "string"
-          },
-          "status": {
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "count": {
-        "type": "integer"
-      },
-      "dimension_row_count": {
-        "type": "integer"
-      },
-      "items": {
-        "items": {
-          "properties": {
-            "ad_account_id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "ad_id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "ad_name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "adset_id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "adset_name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "bid_amount": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "bid_strategy": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "breakdown_key": {
-              "type": "string"
-            },
-            "breakdown_type": {
-              "type": "string"
-            },
-            "budget_level": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "campaign_id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "campaign_name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "campaign_row_count": {
-              "type": "integer"
-            },
-            "clicks": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "configured_status": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "conversion_value": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "conversions": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "cpa": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "cpc": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "cpc_usd": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "cpm": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "cpm_usd": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "ctr": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "currency": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "daily_budget": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "data_as_of_date": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "date": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "date_from": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "date_start": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "date_stop": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "date_to": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "delivery_issue_codes": {
-              "items": {
-                "type": "string"
-              },
-              "type": "array"
-            },
-            "delivery_status": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "effective_status": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "entity_id": {
-              "type": "string"
-            },
-            "entity_name": {
-              "type": "string"
-            },
-            "event_metrics": {
-              "additionalProperties": {
-                "properties": {
-                  "cost_usd": {
-                    "type": "number"
-                  },
-                  "count": {
-                    "type": "number"
-                  },
-                  "cvr_clicks": {
-                    "type": "number"
-                  }
-                },
-                "type": "object"
-              },
-              "type": "object"
-            },
-            "funnel": {
-              "additionalProperties": {
-                "type": "number"
-              },
-              "type": "object"
-            },
-            "id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "impressions": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "level": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "lifetime_budget": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "money_unit": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "optimization_goal": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "primary_event_count": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "primary_event_cpa_usd": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "primary_event_name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "product_type": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "reach": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "roas": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "rollup": {
-              "type": "string"
-            },
-            "source_observed_at": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "spend": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "spend_usd": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "status": {
-              "type": [
-                "string",
-                "null"
-              ]
-            }
-          },
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "meta": {
-        "properties": {
-          "cache_hit": {
-            "type": "boolean"
-          },
-          "coalesced": {
-            "type": "boolean"
-          },
-          "complete": {
-            "type": "boolean"
-          },
-          "data_as_of_date": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "data_freshness": {
-            "properties": {
-              "interval_min": {
-                "type": "integer"
-              },
-              "label": {
-                "type": "string"
-              },
-              "last_pull_failed_account_count": {
-                "type": [
-                  "integer",
-                  "null"
-                ]
-              },
-              "last_pull_scope": {
-                "const": "workspace"
-              },
-              "last_pull_status": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "last_pulled_at": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "max_staleness_min": {
-                "type": "integer"
-              },
-              "server_now_utc": {
-                "type": "string"
-              },
-              "staleness_seconds": {
-                "type": [
-                  "integer",
-                  "null"
-                ]
-              }
-            },
-            "type": "object"
-          },
-          "duration_ms": {
-            "type": "integer"
-          },
-          "failed": {
-            "type": "integer"
-          },
-          "freshness_warnings": {
-            "items": {
-              "properties": {
-                "account_count": {
-                  "type": "integer"
-                },
-                "code": {
-                  "type": "string"
-                },
-                "dispersion_seconds": {
-                  "type": "integer"
-                },
-                "last_pull_failed_account_count": {
-                  "type": [
-                    "integer",
-                    "null"
-                  ]
-                },
-                "last_pull_status": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "message": {
-                  "type": "string"
-                },
-                "metrics_source_observed_at": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "newest_source_observed_at": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "observed_account_count": {
-                  "type": "integer"
-                },
-                "oldest_source_observed_at": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                }
-              },
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "has_more": {
-            "type": "boolean"
-          },
-          "item_count": {
-            "type": "integer"
-          },
-          "limitations": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "metrics_source_observed_at": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "missing_scopes": {
-            "items": {
-              "properties": {
-                "index": {
-                  "type": "integer"
-                },
-                "status": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "index",
-                "status"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "next_cursor": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "page": {
-            "type": "integer"
-          },
-          "page_size": {
-            "type": "integer"
-          },
-          "refresh_reused": {
-            "type": "boolean"
-          },
-          "returned_count": {
-            "type": "integer"
-          },
-          "scope_count": {
-            "type": "integer"
-          },
-          "source": {
-            "type": "string"
-          },
-          "source_observed_at": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "source_row_count": {
-            "type": "integer"
-          },
-          "source_truncated": {
-            "type": "boolean"
-          },
-          "source_watermark": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "succeeded": {
-            "type": "integer"
-          },
-          "total_count": {
-            "type": [
-              "integer",
-              "null"
-            ]
-          },
-          "total_items": {
-            "type": "integer"
-          },
-          "total_pages": {
-            "type": "integer"
-          }
-        },
-        "type": "object"
-      },
-      "rollup": {
-        "type": "string"
-      },
-      "routing": {
-        "properties": {
-          "cache_coverage": {
-            "properties": {
-              "products": {
-                "additionalProperties": {
-                  "properties": {
-                    "complete": {
-                      "type": "boolean"
-                    },
-                    "has_more": {
-                      "type": "boolean"
-                    },
-                    "limitations": {
-                      "items": {
-                        "type": "string"
-                      },
-                      "type": "array"
-                    },
-                    "next_cursor": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "returned_count": {
-                      "type": "integer"
-                    },
-                    "source": {
-                      "type": "string"
-                    },
-                    "source_observed_at": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "source_watermark": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "total_count": {
-                      "type": [
-                        "integer",
-                        "null"
-                      ]
-                    }
-                  },
-                  "type": "object"
-                },
-                "type": "object"
-              },
-              "status": {
-                "type": "string"
-              }
-            },
-            "type": "object"
-          },
-          "decision": {
-            "type": "string"
-          },
-          "pull_breakdowns": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "quota": {
-            "properties": {
-              "available": {
-                "type": "boolean"
-              },
-              "limit": {
-                "type": [
-                  "integer",
-                  "null"
-                ]
-              },
-              "operator_bypass": {
-                "type": "boolean"
-              },
-              "remaining": {
-                "type": "integer"
-              },
-              "used": {
-                "type": "integer"
-              }
-            },
-            "type": "object"
-          },
-          "reason": {
-            "type": "string"
-          },
-          "recommended_next_tool": {
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "stored_row_count": {
-        "type": [
-          "integer",
-          "null"
-        ]
-      },
-      "totals": {
-        "properties": {
-          "clicks": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "conversion_value": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "conversions": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "cpa": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "cpc": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "cpm": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "ctr": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "funnel": {
-            "additionalProperties": {
-              "type": "number"
-            },
-            "type": "object"
-          },
-          "impressions": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "reach": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "roas": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "spend": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "spend_usd": {
-            "type": [
-              "number",
-              "null"
-            ]
-          }
-        },
-        "type": "object"
-      },
-      "truncated": {
-        "type": "boolean"
-      }
-    },
-    "required": [
-      "items",
-      "count",
-      "truncated",
-      "rollup",
-      "meta",
-      "routing"
-    ]
-  },
-  {
-    "properties": {
-      "expires_at": {
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      },
-      "poll": {
-        "properties": {
-          "arguments": {
-            "properties": {
-              "product_ref": {
-                "type": "string"
-              },
-              "task_ref": {
-                "type": "string"
-              },
-              "template_name": {
-                "type": "string"
-              }
-            },
-            "type": "object"
-          },
-          "name": {
-            "type": "string"
-          },
-          "tool": {
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "poll_after_ms": {
-        "type": "integer"
-      },
-      "status": {
-        "const": "queued"
-      },
-      "submitted_new": {
-        "type": "boolean"
-      },
-      "task_ref": {
-        "type": "string"
-      },
-      "task_status": {
-        "type": "string"
-      },
-      "task_type": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "status",
-      "task_ref",
-      "task_status",
-      "poll_after_ms",
-      "expires_at",
-      "poll"
-    ]
-  }
-]New value: +[
+  {
+    "properties": {
+      "ad_ids": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "cache_hint": {
+        "properties": {
+          "message": {
+            "type": "string"
+          },
+          "recommended_next_tool": {
+            "type": "string"
+          },
+          "status": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "complete": {
+        "type": "boolean"
+      },
+      "count": {
+        "type": "integer"
+      },
+      "dimension_row_count": {
+        "type": "integer"
+      },
+      "items": {
+        "items": {
+          "properties": {
+            "ad_account_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "ad_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "ad_name": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "adset_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "adset_name": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "bid_amount": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "bid_strategy": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "breakdown_key": {
+              "type": "string"
+            },
+            "breakdown_type": {
+              "type": "string"
+            },
+            "budget_level": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "campaign_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "campaign_name": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "campaign_row_count": {
+              "type": "integer"
+            },
+            "clicks": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "configured_status": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "conversion_value": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "conversions": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "cpa": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "cpc": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "cpc_usd": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "cpm": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "cpm_usd": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "ctr": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "currency": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "daily_budget": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "data_as_of_date": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "date": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "date_from": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "date_start": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "date_stop": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "date_to": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "delivery_issue_codes": {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            "delivery_status": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "effective_status": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "entity_id": {
+              "type": "string"
+            },
+            "entity_name": {
+              "type": "string"
+            },
+            "event_metrics": {
+              "additionalProperties": {
+                "properties": {
+                  "cost_usd": {
+                    "type": "number"
+                  },
+                  "count": {
+                    "type": "number"
+                  },
+                  "cvr_clicks": {
+                    "type": "number"
+                  }
+                },
+                "type": "object"
+              },
+              "type": "object"
+            },
+            "funnel": {
+              "additionalProperties": {
+                "type": "number"
+              },
+              "type": "object"
+            },
+            "id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "impressions": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "level": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "lifetime_budget": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "money_unit": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "name": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "optimization_goal": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "primary_event_count": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "primary_event_cpa_usd": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "primary_event_name": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "product_type": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "reach": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "roas": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "rollup": {
+              "type": "string"
+            },
+            "source_observed_at": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "spend": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "spend_usd": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "status": {
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "meta": {
+        "properties": {
+          "cache_hit": {
+            "type": "boolean"
+          },
+          "coalesced": {
+            "type": "boolean"
+          },
+          "complete": {
+            "type": "boolean"
+          },
+          "data_as_of_date": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "data_freshness": {
+            "properties": {
+              "interval_min": {
+                "type": "integer"
+              },
+              "label": {
+                "type": "string"
+              },
+              "last_pull_failed_account_count": {
+                "type": [
+                  "integer",
+                  "null"
+                ]
+              },
+              "last_pull_scope": {
+                "const": "workspace"
+              },
+              "last_pull_status": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "last_pulled_at": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "max_staleness_min": {
+                "type": "integer"
+              },
+              "server_now_utc": {
+                "type": "string"
+              },
+              "staleness_seconds": {
+                "type": [
+                  "integer",
+                  "null"
+                ]
+              }
+            },
+            "type": "object"
+          },
+          "duration_ms": {
+            "type": "integer"
+          },
+          "failed": {
+            "type": "integer"
+          },
+          "freshness_warnings": {
+            "items": {
+              "properties": {
+                "account_count": {
+                  "type": "integer"
+                },
+                "code": {
+                  "type": "string"
+                },
+                "dispersion_seconds": {
+                  "type": "integer"
+                },
+                "last_pull_failed_account_count": {
+                  "type": [
+                    "integer",
+                    "null"
+                  ]
+                },
+                "last_pull_status": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "message": {
+                  "type": "string"
+                },
+                "metrics_source_observed_at": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "newest_source_observed_at": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "observed_account_count": {
+                  "type": "integer"
+                },
+                "oldest_source_observed_at": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "has_more": {
+            "type": "boolean"
+          },
+          "item_count": {
+            "type": "integer"
+          },
+          "limitations": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "metrics_source_observed_at": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "missing_scopes": {
+            "items": {
+              "properties": {
+                "index": {
+                  "type": "integer"
+                },
+                "status": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "index",
+                "status"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "next_cursor": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "page": {
+            "type": "integer"
+          },
+          "page_size": {
+            "type": "integer"
+          },
+          "refresh_reused": {
+            "type": "boolean"
+          },
+          "returned_count": {
+            "type": "integer"
+          },
+          "scope_count": {
+            "type": "integer"
+          },
+          "source": {
+            "type": "string"
+          },
+          "source_observed_at": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "source_row_count": {
+            "type": "integer"
+          },
+          "source_truncated": {
+            "type": "boolean"
+          },
+          "source_watermark": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "succeeded": {
+            "type": "integer"
+          },
+          "total_count": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "total_items": {
+            "type": "integer"
+          },
+          "total_pages": {
+            "type": "integer"
+          }
+        },
+        "type": "object"
+      },
+      "next_cursor": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "rollup": {
+        "type": "string"
+      },
+      "routing": {
+        "properties": {
+          "cache_coverage": {
+            "properties": {
+              "products": {
+                "additionalProperties": {
+                  "properties": {
+                    "complete": {
+                      "type": "boolean"
+                    },
+                    "has_more": {
+                      "type": "boolean"
+                    },
+                    "limitations": {
+                      "items": {
+                        "type": "string"
+                      },
+                      "type": "array"
+                    },
+                    "next_cursor": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "returned_count": {
+                      "type": "integer"
+                    },
+                    "source": {
+                      "type": "string"
+                    },
+                    "source_observed_at": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "source_watermark": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "total_count": {
+                      "type": [
+                        "integer",
+                        "null"
+                      ]
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "object"
+              },
+              "status": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "decision": {
+            "type": "string"
+          },
+          "pull_breakdowns": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "quota": {
+            "properties": {
+              "available": {
+                "type": "boolean"
+              },
+              "limit": {
+                "type": [
+                  "integer",
+                  "null"
+                ]
+              },
+              "operator_bypass": {
+                "type": "boolean"
+              },
+              "remaining": {
+                "type": "integer"
+              },
+              "used": {
+                "type": "integer"
+              }
+            },
+            "type": "object"
+          },
+          "reason": {
+            "type": "string"
+          },
+          "recommended_next_tool": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "stored_row_count": {
+        "type": [
+          "integer",
+          "null"
+        ]
+      },
+      "totals": {
+        "properties": {
+          "clicks": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "conversion_value": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "conversions": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "cpa": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "cpc": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "cpm": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "ctr": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "funnel": {
+            "additionalProperties": {
+              "type": "number"
+            },
+            "type": "object"
+          },
+          "impressions": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "reach": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "roas": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "spend": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "spend_usd": {
+            "type": [
+              "number",
+              "null"
+            ]
+          }
+        },
+        "type": "object"
+      },
+      "truncated": {
+        "type": "boolean"
+      }
+    },
+    "required": [
+      "items",
+      "count",
+      "truncated",
+      "rollup",
+      "meta",
+      "routing"
+    ]
+  },
+  {
+    "properties": {
+      "expires_at": {
+        "type": "string"
+      },
+      "message": {
+        "type": "string"
+      },
+      "poll": {
+        "properties": {
+          "arguments": {
+            "properties": {
+              "product_ref": {
+                "type": "string"
+              },
+              "task_ref": {
+                "type": "string"
+              },
+              "template_name": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "name": {
+            "type": "string"
+          },
+          "tool": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "poll_after_ms": {
+        "type": "integer"
+      },
+      "status": {
+        "const": "queued"
+      },
+      "submitted_new": {
+        "type": "boolean"
+      },
+      "task_ref": {
+        "type": "string"
+      },
+      "task_status": {
+        "type": "string"
+      },
+      "task_type": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "status",
+      "task_ref",
+      "task_status",
+      "poll_after_ms",
+      "expires_at",
+      "poll"
+    ]
+  }
+]

Changed1 schema field changedSep 10, 2026

changedOutput schema / else / anyOf

Previous value: -[
-  {
-    "properties": {
-      "cache_hint": {
-        "properties": {
-          "message": {
-            "type": "string"
-          },
-          "recommended_next_tool": {
-            "type": "string"
-          },
-          "status": {
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "count": {
-        "type": "integer"
-      },
-      "dimension_row_count": {
-        "type": "integer"
-      },
-      "items": {
-        "items": {
-          "properties": {
-            "ad_account_id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "ad_id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "ad_name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "adset_id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "adset_name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "bid_amount": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "bid_strategy": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "breakdown_key": {
-              "type": "string"
-            },
-            "breakdown_type": {
-              "type": "string"
-            },
-            "budget_level": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "campaign_id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "campaign_name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "campaign_row_count": {
-              "type": "integer"
-            },
-            "clicks": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "configured_status": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "conversion_value": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "conversions": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "cpa": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "cpc": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "cpc_usd": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "cpm": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "cpm_usd": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "ctr": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "currency": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "daily_budget": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "data_as_of_date": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "date": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "date_from": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "date_start": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "date_stop": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "date_to": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "delivery_issue_codes": {
-              "items": {
-                "type": "string"
-              },
-              "type": "array"
-            },
-            "delivery_status": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "effective_status": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "entity_id": {
-              "type": "string"
-            },
-            "entity_name": {
-              "type": "string"
-            },
-            "event_metrics": {
-              "additionalProperties": {
-                "properties": {
-                  "cost_usd": {
-                    "type": "number"
-                  },
-                  "count": {
-                    "type": "number"
-                  },
-                  "cvr_clicks": {
-                    "type": "number"
-                  }
-                },
-                "type": "object"
-              },
-              "type": "object"
-            },
-            "funnel": {
-              "additionalProperties": {
-                "type": "number"
-              },
-              "type": "object"
-            },
-            "id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "impressions": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "level": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "lifetime_budget": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "money_unit": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "optimization_goal": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "primary_event_count": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "primary_event_cpa_usd": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "primary_event_name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "product_type": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "reach": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "roas": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "rollup": {
-              "type": "string"
-            },
-            "source_observed_at": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "spend": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "spend_usd": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "status": {
-              "type": [
-                "string",
-                "null"
-              ]
-            }
-          },
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "meta": {
-        "properties": {
-          "cache_hit": {
-            "type": "boolean"
-          },
-          "coalesced": {
-            "type": "boolean"
-          },
-          "complete": {
-            "type": "boolean"
-          },
-          "data_as_of_date": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "data_freshness": {
-            "properties": {
-              "interval_min": {
-                "type": "integer"
-              },
-              "label": {
-                "type": "string"
-              },
-              "last_pull_failed_account_count": {
-                "type": [
-                  "integer",
-                  "null"
-                ]
-              },
-              "last_pull_status": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "last_pulled_at": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "max_staleness_min": {
-                "type": "integer"
-              },
-              "server_now_utc": {
-                "type": "string"
-              },
-              "staleness_seconds": {
-                "type": [
-                  "integer",
-                  "null"
-                ]
-              }
-            },
-            "type": "object"
-          },
-          "duration_ms": {
-            "type": "integer"
-          },
-          "failed": {
-            "type": "integer"
-          },
-          "freshness_warnings": {
-            "items": {
-              "properties": {
-                "account_count": {
-                  "type": "integer"
-                },
-                "code": {
-                  "type": "string"
-                },
-                "dispersion_seconds": {
-                  "type": "integer"
-                },
-                "last_pull_failed_account_count": {
-                  "type": [
-                    "integer",
-                    "null"
-                  ]
-                },
-                "last_pull_status": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "message": {
-                  "type": "string"
-                },
-                "metrics_source_observed_at": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "newest_source_observed_at": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "observed_account_count": {
-                  "type": "integer"
-                },
-                "oldest_source_observed_at": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                }
-              },
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "has_more": {
-            "type": "boolean"
-          },
-          "item_count": {
-            "type": "integer"
-          },
-          "limitations": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "metrics_source_observed_at": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "missing_scopes": {
-            "items": {
-              "properties": {
-                "index": {
-                  "type": "integer"
-                },
-                "status": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "index",
-                "status"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "next_cursor": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "page": {
-            "type": "integer"
-          },
-          "page_size": {
-            "type": "integer"
-          },
-          "refresh_reused": {
-            "type": "boolean"
-          },
-          "returned_count": {
-            "type": "integer"
-          },
-          "scope_count": {
-            "type": "integer"
-          },
-          "source": {
-            "type": "string"
-          },
-          "source_observed_at": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "source_row_count": {
-            "type": "integer"
-          },
-          "source_truncated": {
-            "type": "boolean"
-          },
-          "source_watermark": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "succeeded": {
-            "type": "integer"
-          },
-          "total_count": {
-            "type": [
-              "integer",
-              "null"
-            ]
-          },
-          "total_items": {
-            "type": "integer"
-          },
-          "total_pages": {
-            "type": "integer"
-          }
-        },
-        "type": "object"
-      },
-      "rollup": {
-        "type": "string"
-      },
-      "routing": {
-        "properties": {
-          "cache_coverage": {
-            "properties": {
-              "products": {
-                "additionalProperties": {
-                  "properties": {
-                    "complete": {
-                      "type": "boolean"
-                    },
-                    "has_more": {
-                      "type": "boolean"
-                    },
-                    "limitations": {
-                      "items": {
-                        "type": "string"
-                      },
-                      "type": "array"
-                    },
-                    "next_cursor": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "returned_count": {
-                      "type": "integer"
-                    },
-                    "source": {
-                      "type": "string"
-                    },
-                    "source_observed_at": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "source_watermark": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "total_count": {
-                      "type": [
-                        "integer",
-                        "null"
-                      ]
-                    }
-                  },
-                  "type": "object"
-                },
-                "type": "object"
-              },
-              "status": {
-                "type": "string"
-              }
-            },
-            "type": "object"
-          },
-          "decision": {
-            "type": "string"
-          },
-          "pull_breakdowns": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "quota": {
-            "properties": {
-              "available": {
-                "type": "boolean"
-              },
-              "limit": {
-                "type": [
-                  "integer",
-                  "null"
-                ]
-              },
-              "operator_bypass": {
-                "type": "boolean"
-              },
-              "remaining": {
-                "type": "integer"
-              },
-              "used": {
-                "type": "integer"
-              }
-            },
-            "type": "object"
-          },
-          "reason": {
-            "type": "string"
-          },
-          "recommended_next_tool": {
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "stored_row_count": {
-        "type": [
-          "integer",
-          "null"
-        ]
-      },
-      "totals": {
-        "properties": {
-          "clicks": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "conversion_value": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "conversions": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "cpa": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "cpc": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "cpm": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "ctr": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "funnel": {
-            "additionalProperties": {
-              "type": "number"
-            },
-            "type": "object"
-          },
-          "impressions": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "reach": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "roas": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "spend": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "spend_usd": {
-            "type": [
-              "number",
-              "null"
-            ]
-          }
-        },
-        "type": "object"
-      },
-      "truncated": {
-        "type": "boolean"
-      }
-    },
-    "required": [
-      "items",
-      "count",
-      "truncated",
-      "rollup",
-      "meta",
-      "routing"
-    ]
-  },
-  {
-    "properties": {
-      "expires_at": {
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      },
-      "poll": {
-        "properties": {
-          "arguments": {
-            "properties": {
-              "product_ref": {
-                "type": "string"
-              },
-              "task_ref": {
-                "type": "string"
-              },
-              "template_name": {
-                "type": "string"
-              }
-            },
-            "type": "object"
-          },
-          "name": {
-            "type": "string"
-          },
-          "tool": {
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "poll_after_ms": {
-        "type": "integer"
-      },
-      "status": {
-        "const": "queued"
-      },
-      "submitted_new": {
-        "type": "boolean"
-      },
-      "task_ref": {
-        "type": "string"
-      },
-      "task_status": {
-        "type": "string"
-      },
-      "task_type": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "status",
-      "task_ref",
-      "task_status",
-      "poll_after_ms",
-      "expires_at",
-      "poll"
-    ]
-  }
-]New value: +[
+  {
+    "properties": {
+      "cache_hint": {
+        "properties": {
+          "message": {
+            "type": "string"
+          },
+          "recommended_next_tool": {
+            "type": "string"
+          },
+          "status": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "count": {
+        "type": "integer"
+      },
+      "dimension_row_count": {
+        "type": "integer"
+      },
+      "items": {
+        "items": {
+          "properties": {
+            "ad_account_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "ad_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "ad_name": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "adset_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "adset_name": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "bid_amount": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "bid_strategy": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "breakdown_key": {
+              "type": "string"
+            },
+            "breakdown_type": {
+              "type": "string"
+            },
+            "budget_level": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "campaign_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "campaign_name": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "campaign_row_count": {
+              "type": "integer"
+            },
+            "clicks": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "configured_status": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "conversion_value": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "conversions": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "cpa": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "cpc": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "cpc_usd": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "cpm": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "cpm_usd": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "ctr": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "currency": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "daily_budget": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "data_as_of_date": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "date": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "date_from": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "date_start": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "date_stop": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "date_to": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "delivery_issue_codes": {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            "delivery_status": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "effective_status": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "entity_id": {
+              "type": "string"
+            },
+            "entity_name": {
+              "type": "string"
+            },
+            "event_metrics": {
+              "additionalProperties": {
+                "properties": {
+                  "cost_usd": {
+                    "type": "number"
+                  },
+                  "count": {
+                    "type": "number"
+                  },
+                  "cvr_clicks": {
+                    "type": "number"
+                  }
+                },
+                "type": "object"
+              },
+              "type": "object"
+            },
+            "funnel": {
+              "additionalProperties": {
+                "type": "number"
+              },
+              "type": "object"
+            },
+            "id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "impressions": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "level": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "lifetime_budget": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "money_unit": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "name": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "optimization_goal": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "primary_event_count": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "primary_event_cpa_usd": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "primary_event_name": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "product_type": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "reach": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "roas": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "rollup": {
+              "type": "string"
+            },
+            "source_observed_at": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "spend": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "spend_usd": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "status": {
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "meta": {
+        "properties": {
+          "cache_hit": {
+            "type": "boolean"
+          },
+          "coalesced": {
+            "type": "boolean"
+          },
+          "complete": {
+            "type": "boolean"
+          },
+          "data_as_of_date": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "data_freshness": {
+            "properties": {
+              "interval_min": {
+                "type": "integer"
+              },
+              "label": {
+                "type": "string"
+              },
+              "last_pull_failed_account_count": {
+                "type": [
+                  "integer",
+                  "null"
+                ]
+              },
+              "last_pull_scope": {
+                "const": "workspace"
+              },
+              "last_pull_status": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "last_pulled_at": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "max_staleness_min": {
+                "type": "integer"
+              },
+              "server_now_utc": {
+                "type": "string"
+              },
+              "staleness_seconds": {
+                "type": [
+                  "integer",
+                  "null"
+                ]
+              }
+            },
+            "type": "object"
+          },
+          "duration_ms": {
+            "type": "integer"
+          },
+          "failed": {
+            "type": "integer"
+          },
+          "freshness_warnings": {
+            "items": {
+              "properties": {
+                "account_count": {
+                  "type": "integer"
+                },
+                "code": {
+                  "type": "string"
+                },
+                "dispersion_seconds": {
+                  "type": "integer"
+                },
+                "last_pull_failed_account_count": {
+                  "type": [
+                    "integer",
+                    "null"
+                  ]
+                },
+                "last_pull_status": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "message": {
+                  "type": "string"
+                },
+                "metrics_source_observed_at": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "newest_source_observed_at": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "observed_account_count": {
+                  "type": "integer"
+                },
+                "oldest_source_observed_at": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "has_more": {
+            "type": "boolean"
+          },
+          "item_count": {
+            "type": "integer"
+          },
+          "limitations": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "metrics_source_observed_at": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "missing_scopes": {
+            "items": {
+              "properties": {
+                "index": {
+                  "type": "integer"
+                },
+                "status": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "index",
+                "status"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "next_cursor": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "page": {
+            "type": "integer"
+          },
+          "page_size": {
+            "type": "integer"
+          },
+          "refresh_reused": {
+            "type": "boolean"
+          },
+          "returned_count": {
+            "type": "integer"
+          },
+          "scope_count": {
+            "type": "integer"
+          },
+          "source": {
+            "type": "string"
+          },
+          "source_observed_at": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "source_row_count": {
+            "type": "integer"
+          },
+          "source_truncated": {
+            "type": "boolean"
+          },
+          "source_watermark": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "succeeded": {
+            "type": "integer"
+          },
+          "total_count": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "total_items": {
+            "type": "integer"
+          },
+          "total_pages": {
+            "type": "integer"
+          }
+        },
+        "type": "object"
+      },
+      "rollup": {
+        "type": "string"
+      },
+      "routing": {
+        "properties": {
+          "cache_coverage": {
+            "properties": {
+              "products": {
+                "additionalProperties": {
+                  "properties": {
+                    "complete": {
+                      "type": "boolean"
+                    },
+                    "has_more": {
+                      "type": "boolean"
+                    },
+                    "limitations": {
+                      "items": {
+                        "type": "string"
+                      },
+                      "type": "array"
+                    },
+                    "next_cursor": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "returned_count": {
+                      "type": "integer"
+                    },
+                    "source": {
+                      "type": "string"
+                    },
+                    "source_observed_at": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "source_watermark": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "total_count": {
+                      "type": [
+                        "integer",
+                        "null"
+                      ]
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "object"
+              },
+              "status": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "decision": {
+            "type": "string"
+          },
+          "pull_breakdowns": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "quota": {
+            "properties": {
+              "available": {
+                "type": "boolean"
+              },
+              "limit": {
+                "type": [
+                  "integer",
+                  "null"
+                ]
+              },
+              "operator_bypass": {
+                "type": "boolean"
+              },
+              "remaining": {
+                "type": "integer"
+              },
+              "used": {
+                "type": "integer"
+              }
+            },
+            "type": "object"
+          },
+          "reason": {
+            "type": "string"
+          },
+          "recommended_next_tool": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "stored_row_count": {
+        "type": [
+          "integer",
+          "null"
+        ]
+      },
+      "totals": {
+        "properties": {
+          "clicks": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "conversion_value": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "conversions": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "cpa": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "cpc": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "cpm": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "ctr": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "funnel": {
+            "additionalProperties": {
+              "type": "number"
+            },
+            "type": "object"
+          },
+          "impressions": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "reach": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "roas": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "spend": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "spend_usd": {
+            "type": [
+              "number",
+              "null"
+            ]
+          }
+        },
+        "type": "object"
+      },
+      "truncated": {
+        "type": "boolean"
+      }
+    },
+    "required": [
+      "items",
+      "count",
+      "truncated",
+      "rollup",
+      "meta",
+      "routing"
+    ]
+  },
+  {
+    "properties": {
+      "expires_at": {
+        "type": "string"
+      },
+      "message": {
+        "type": "string"
+      },
+      "poll": {
+        "properties": {
+          "arguments": {
+            "properties": {
+              "product_ref": {
+                "type": "string"
+              },
+              "task_ref": {
+                "type": "string"
+              },
+              "template_name": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "name": {
+            "type": "string"
+          },
+          "tool": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "poll_after_ms": {
+        "type": "integer"
+      },
+      "status": {
+        "const": "queued"
+      },
+      "submitted_new": {
+        "type": "boolean"
+      },
+      "task_ref": {
+        "type": "string"
+      },
+      "task_status": {
+        "type": "string"
+      },
+      "task_type": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "status",
+      "task_ref",
+      "task_status",
+      "poll_after_ms",
+      "expires_at",
+      "poll"
+    ]
+  }
+]

First observedSep 9, 2026

TDQS

A3.8/5.0

Behavior5/5

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

Adds substantial context beyond the annotations: it discloses that a cache miss may queue a bounded pull and return a task_ref, describes the follow-up polling loop, states that automatic pulls draw on the existing daily quota, and reassures that ad delivery is unaffected. This also reconciles the readOnlyHint=false annotation, since the tool has a side effect (queuing a pull) despite being framed as a read.

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?

Four dense sentences, front-loaded with what is read and for what scope before moving to cache/poll behavior. Nothing is obviously filler, though the quota/delivery sentence could be tightened.

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

Completeness3/5

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

An output schema exists, so return values needn't be explained, and the async cache-miss path is well covered. However, for an 11-parameter tool with zero schema coverage and three enums, the description leaves an agent without enough information about pagination (cursor/limit) and aggregation (level/rollup) to call it correctly.

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

Parameters2/5

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

Schema description coverage is 0% across 11 parameters, so the description must carry the load, yet it only touches product_ref/product_name, date window, and breakdown_type. Key params like level, rollup, cursor, limit, ad_ids, and conversion_event are left entirely undocumented, and the description never explains the level-vs-rollup interplay.

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

Purpose4/5

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

States a specific verb and resource: reading Meta breakdown metrics across named dimensions (country, placement, age, gender, OS, hourly) for one product and date window. The scope is clearly narrower than generic insight query siblings, but it never names the adjacent tools (insights_pull_product_breakdowns, insights_pull_insights, insights_query_overview) to disambiguate read-vs-pull.

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

Usage Guidelines4/5

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

Gives a concrete usage path: call this first, and on a cache miss poll tasks_get_status then re-issue with identical filters. It also clarifies quota consumption. What's missing is explicit routing guidance against alternatives (when to use the pull tool or the export tool instead), so it stops short of a 5.

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

All AdsAgent — Meta Ads MCP 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?