AdsAgent — Meta Ads MCP

insights_query_consistent

Read one scope or a server-side batch. For query_contract_version=1 supply group_by, dates and scope/scopes via request OR direct fields. cached reads stored data; fresh modes may queue refresh tasks. Poll the returned task_ref without duplicate refreshes. Check complete and coverage before using totals; never infer zero from partial data

Input Schema

TableJSON Schema

Name	Required	Default
`page`	No
`scope`	No
`fields`	No
`scopes`	No
`search`	No
`date_to`	No
`filters`	No
`request`	No
`wait_ms`	No
`group_by`	No
`spend_gt`	No
`date_from`	No
`dedupe_by`	No
`min_as_of`	No
`page_size`	No
`consistency`	No	cached
`response_mode`	No	compact
`date_range_mode`	No	explicit
`inventory_anchors`	No
`after_mutation_ref`	No
`query_contract_version`	No
`require_complete_range`	No

Output Schema

TableJSON Schema

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

Schema Changelog

Changes observed during successful MCP inspections.

Changed122 schema fields changedSep 13, 2026

addedOutput schema / $defs / s1 / items / properties / configured_status_observed_at
```
Added value: +{
+  "$ref": "#/$defs/s4"
+}
```
changedOutput schema / $defs / s1 / items / properties / funnel_observation / $ref
```
Previous value: -"#/$defs/s4"New value: +"#/$defs/s5"
```
removedOutput schema / $defs / s10 / properties / can_report_stored_total
```
Removed value: -{
-  "type": "boolean"
-}
```
addedOutput schema / $defs / s10 / properties / category
```
Added value: +{
+  "type": "string"
+}
```
addedOutput schema / $defs / s10 / properties / code
```
Added value: +{
+  "type": "string"
+}
```
addedOutput schema / $defs / s10 / properties / message
```
Added value: +{
+  "type": "string"
+}
```
removedOutput schema / $defs / s10 / properties / reason
```
Removed value: -{
-  "type": "string"
-}
```

addedOutput schema / $defs / s10 / properties / retry_after_seconds

Added value: +{
+  "type": [
+    "integer",
+    "null"
+  ]
+}

addedOutput schema / $defs / s10 / properties / retryable
```
Added value: +{
+  "type": "boolean"
+}
```
addedOutput schema / $defs / s10 / properties / subcode
```
Added value: +{
+  "type": "string"
+}
```
removedOutput schema / $defs / s10 / properties / zero_proven
```
Removed value: -{
-  "type": "boolean"
-}
```

removedOutput schema / $defs / s10 / required

Removed value: -[
-  "can_report_stored_total",
-  "zero_proven",
-  "reason"
-]

changedOutput schema / $defs / s10 / type

Previous value: -"object"New value: +[
+  "null",
+  "object"
+]

addedOutput schema / $defs / s11

Added value: +{
+  "properties": {
+    "can_report_stored_total": {
+      "type": "boolean"
+    },
+    "reason": {
+      "type": "string"
+    },
+    "zero_proven": {
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "can_report_stored_total",
+    "zero_proven",
+    "reason"
+  ],
+  "type": "object"
+}

addedOutput schema / $defs / s4 / description

Added value: +"Configuration snapshot time only."

addedOutput schema / $defs / s4 / format
```
Added value: +"date-time"
```

removedOutput schema / $defs / s4 / properties

Removed value: -{
-  "proves_source_coverage": {
-    "const": false
-  },
-  "proves_zero": {
-    "const": false
-  },
-  "status": {
-    "enum": [
-      "selected_events_returned",
-      "no_selected_events_returned",
-      "read_unverified",
-      "insights_unavailable"
-    ]
-  }
-}

changedOutput schema / $defs / s4 / type

Previous value: -"object"New value: +"string"

addedOutput schema / $defs / s5

Added value: +{
+  "properties": {
+    "proves_source_coverage": {
+      "const": false
+    },
+    "proves_zero": {
+      "const": false
+    },
+    "status": {
+      "enum": [
+        "selected_events_returned",
+        "no_selected_events_returned",
+        "read_unverified",
+        "insights_unavailable"
+      ]
+    }
+  },
+  "type": "object"
+}

removedOutput schema / $defs / s6

Removed value: -{
-  "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": {
-      "$ref": "#/$defs/s3"
-    },
-    "impressions": {
-      "type": [
-        "number",
-        "null"
-      ]
-    },
-    "reach": {
-      "type": [
-        "number",
-        "null"
-      ]
-    },
-    "roas": {
-      "type": [
-        "number",
-        "null"
-      ]
-    },
-    "spend": {
-      "type": [
-        "number",
-        "null"
-      ]
-    },
-    "spend_usd": {
-      "type": [
-        "number",
-        "null"
-      ]
-    }
-  },
-  "type": "object"
-}

addedOutput schema / $defs / s7 / properties / clicks

Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}

addedOutput schema / $defs / s7 / properties / conversion_value

Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}

addedOutput schema / $defs / s7 / properties / conversions

Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}

removedOutput schema / $defs / s7 / properties / coverage_requirement

Removed value: -{
-  "const": "verify_insights_and_source_coverage"
-}

addedOutput schema / $defs / s7 / properties / cpa

Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}

addedOutput schema / $defs / s7 / properties / cpc

Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}

addedOutput schema / $defs / s7 / properties / cpm

Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}

addedOutput schema / $defs / s7 / properties / ctr

Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}

removedOutput schema / $defs / s7 / properties / empty_funnel_interpretation

Removed value: -{
-  "const": "no_selected_events_returned_not_zero_proof"
-}

addedOutput schema / $defs / s7 / properties / funnel
```
Added value: +{
+  "$ref": "#/$defs/s3"
+}
```

addedOutput schema / $defs / s7 / properties / impressions

Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}

removedOutput schema / $defs / s7 / properties / missing_event_implies_missing_insights
```
Removed value: -{
-  "const": false
-}
```
removedOutput schema / $defs / s7 / properties / missing_event_is_zero
```
Removed value: -{
-  "const": false
-}
```

addedOutput schema / $defs / s7 / properties / reach

Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}

removedOutput schema / $defs / s7 / properties / read_coverage_scope

Removed value: -{
-  "const": "query_result_not_upstream_ingestion"
-}

removedOutput schema / $defs / s7 / properties / representation
```
Removed value: -{
-  "const": "sparse"
-}
```

addedOutput schema / $defs / s7 / properties / roas

Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}

addedOutput schema / $defs / s7 / properties / spend

Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}

addedOutput schema / $defs / s7 / properties / spend_usd

Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}

removedOutput schema / $defs / s8 / properties / cache_hit
```
Removed value: -{
-  "type": "boolean"
-}
```
removedOutput schema / $defs / s8 / properties / coalesced
```
Removed value: -{
-  "type": "boolean"
-}
```
removedOutput schema / $defs / s8 / properties / complete
```
Removed value: -{
-  "type": "boolean"
-}
```

addedOutput schema / $defs / s8 / properties / coverage_requirement

Added value: +{
+  "const": "verify_insights_and_source_coverage"
+}

removedOutput schema / $defs / s8 / properties / data_as_of_date

Removed value: -{
-  "type": [
-    "string",
-    "null"
-  ]
-}

removedOutput schema / $defs / s8 / properties / data_freshness
```
Removed value: -{
-  "$ref": "#/$defs/s9"
-}
```
removedOutput schema / $defs / s8 / properties / duration_ms
```
Removed value: -{
-  "type": "integer"
-}
```

addedOutput schema / $defs / s8 / properties / empty_funnel_interpretation

Added value: +{
+  "const": "no_selected_events_returned_not_zero_proof"
+}

removedOutput schema / $defs / s8 / properties / failed
```
Removed value: -{
-  "type": "integer"
-}
```

removedOutput schema / $defs / s8 / properties / freshness_warnings

Removed value: -{
-  "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"
-}

removedOutput schema / $defs / s8 / properties / funnel_incomplete
```
Removed value: -{
-  "type": "boolean"
-}
```

removedOutput schema / $defs / s8 / properties / funnel_read_coverage

Removed value: -{
-  "properties": {
-    "complete": {
-      "type": "boolean"
-    },
-    "reason": {
-      "type": "string"
-    },
-    "source": {
-      "type": "string"
-    }
-  },
-  "type": "object"
-}

removedOutput schema / $defs / s8 / properties / has_more
```
Removed value: -{
-  "type": "boolean"
-}
```
removedOutput schema / $defs / s8 / properties / item_count
```
Removed value: -{
-  "type": "integer"
-}
```

removedOutput schema / $defs / s8 / properties / limitations

Removed value: -{
-  "items": {
-    "type": "string"
-  },
-  "type": "array"
-}

removedOutput schema / $defs / s8 / properties / metrics_source_observed_at
```
Removed value: -{
-  "type": [
-    "string",
-    "null"
-  ]
-}
```
addedOutput schema / $defs / s8 / properties / missing_event_implies_missing_insights
```
Added value: +{
+  "const": false
+}
```
addedOutput schema / $defs / s8 / properties / missing_event_is_zero
```
Added value: +{
+  "const": false
+}
```

removedOutput schema / $defs / s8 / properties / missing_scopes

Removed value: -{
-  "items": {
-    "properties": {
-      "index": {
-        "type": "integer"
-      },
-      "status": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "index",
-      "status"
-    ],
-    "type": "object"
-  },
-  "type": "array"
-}

removedOutput schema / $defs / s8 / properties / next_cursor

Removed value: -{
-  "type": [
-    "string",
-    "null"
-  ]
-}

removedOutput schema / $defs / s8 / properties / page
```
Removed value: -{
-  "type": "integer"
-}
```
removedOutput schema / $defs / s8 / properties / page_size
```
Removed value: -{
-  "type": "integer"
-}
```

addedOutput schema / $defs / s8 / properties / read_coverage_scope

Added value: +{
+  "const": "query_result_not_upstream_ingestion"
+}

removedOutput schema / $defs / s8 / properties / refresh_reused
```
Removed value: -{
-  "type": "boolean"
-}
```
addedOutput schema / $defs / s8 / properties / representation
```
Added value: +{
+  "const": "sparse"
+}
```
removedOutput schema / $defs / s8 / properties / returned_count
```
Removed value: -{
-  "type": "integer"
-}
```
removedOutput schema / $defs / s8 / properties / scope_count
```
Removed value: -{
-  "type": "integer"
-}
```
removedOutput schema / $defs / s8 / properties / source
```
Removed value: -{
-  "type": "string"
-}
```

removedOutput schema / $defs / s8 / properties / source_observed_at

Removed value: -{
-  "type": [
-    "string",
-    "null"
-  ]
-}

removedOutput schema / $defs / s8 / properties / source_row_count
```
Removed value: -{
-  "type": "integer"
-}
```
removedOutput schema / $defs / s8 / properties / source_truncated
```
Removed value: -{
-  "type": "boolean"
-}
```

removedOutput schema / $defs / s8 / properties / source_watermark

Removed value: -{
-  "type": [
-    "string",
-    "null"
-  ]
-}

removedOutput schema / $defs / s8 / properties / standard_metrics_complete
```
Removed value: -{
-  "type": "boolean"
-}
```
removedOutput schema / $defs / s8 / properties / succeeded
```
Removed value: -{
-  "type": "integer"
-}
```

removedOutput schema / $defs / s8 / properties / total_count

Removed value: -{
-  "type": [
-    "integer",
-    "null"
-  ]
-}

removedOutput schema / $defs / s8 / properties / total_items
```
Removed value: -{
-  "type": "integer"
-}
```
removedOutput schema / $defs / s8 / properties / total_pages
```
Removed value: -{
-  "type": "integer"
-}
```
addedOutput schema / $defs / s9 / properties / cache_hit
```
Added value: +{
+  "type": "boolean"
+}
```
addedOutput schema / $defs / s9 / properties / coalesced
```
Added value: +{
+  "type": "boolean"
+}
```
addedOutput schema / $defs / s9 / properties / complete
```
Added value: +{
+  "type": "boolean"
+}
```

addedOutput schema / $defs / s9 / properties / data_as_of_date

Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}

addedOutput schema / $defs / s9 / properties / data_freshness
```
Added value: +{
+  "$ref": "#/$defs/sa"
+}
```
addedOutput schema / $defs / s9 / properties / duration_ms
```
Added value: +{
+  "type": "integer"
+}
```
addedOutput schema / $defs / s9 / properties / failed
```
Added value: +{
+  "type": "integer"
+}
```

addedOutput schema / $defs / s9 / properties / freshness_warnings

Added value: +{
+  "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"
+}

addedOutput schema / $defs / s9 / properties / funnel_incomplete
```
Added value: +{
+  "type": "boolean"
+}
```

addedOutput schema / $defs / s9 / properties / funnel_read_coverage

Added value: +{
+  "properties": {
+    "complete": {
+      "type": "boolean"
+    },
+    "reason": {
+      "type": "string"
+    },
+    "source": {
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

addedOutput schema / $defs / s9 / properties / has_more
```
Added value: +{
+  "type": "boolean"
+}
```
removedOutput schema / $defs / s9 / properties / interval_min
```
Removed value: -{
-  "type": "integer"
-}
```
addedOutput schema / $defs / s9 / properties / item_count
```
Added value: +{
+  "type": "integer"
+}
```
removedOutput schema / $defs / s9 / properties / label
```
Removed value: -{
-  "type": "string"
-}
```
removedOutput schema / $defs / s9 / properties / last_pull_failed_account_count
```
Removed value: -{
-  "type": [
-    "integer",
-    "null"
-  ]
-}
```
removedOutput schema / $defs / s9 / properties / last_pull_scope
```
Removed value: -{
-  "const": "workspace"
-}
```

removedOutput schema / $defs / s9 / properties / last_pull_status

Removed value: -{
-  "type": [
-    "string",
-    "null"
-  ]
-}

removedOutput schema / $defs / s9 / properties / last_pulled_at

Removed value: -{
-  "type": [
-    "string",
-    "null"
-  ]
-}

addedOutput schema / $defs / s9 / properties / limitations

Added value: +{
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

removedOutput schema / $defs / s9 / properties / max_staleness_min
```
Removed value: -{
-  "type": "integer"
-}
```
addedOutput schema / $defs / s9 / properties / metrics_source_observed_at
```
Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}
```

addedOutput schema / $defs / s9 / properties / missing_scopes

Added value: +{
+  "items": {
+    "properties": {
+      "index": {
+        "type": "integer"
+      },
+      "status": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "index",
+      "status"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

addedOutput schema / $defs / s9 / properties / next_cursor

Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}

addedOutput schema / $defs / s9 / properties / page
```
Added value: +{
+  "type": "integer"
+}
```
addedOutput schema / $defs / s9 / properties / page_size
```
Added value: +{
+  "type": "integer"
+}
```
addedOutput schema / $defs / s9 / properties / refresh_reused
```
Added value: +{
+  "type": "boolean"
+}
```
addedOutput schema / $defs / s9 / properties / returned_count
```
Added value: +{
+  "type": "integer"
+}
```
addedOutput schema / $defs / s9 / properties / scope_count
```
Added value: +{
+  "type": "integer"
+}
```
removedOutput schema / $defs / s9 / properties / server_now_utc
```
Removed value: -{
-  "type": "string"
-}
```
addedOutput schema / $defs / s9 / properties / source
```
Added value: +{
+  "type": "string"
+}
```

addedOutput schema / $defs / s9 / properties / source_observed_at

Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}

addedOutput schema / $defs / s9 / properties / source_row_count
```
Added value: +{
+  "type": "integer"
+}
```
addedOutput schema / $defs / s9 / properties / source_truncated
```
Added value: +{
+  "type": "boolean"
+}
```

addedOutput schema / $defs / s9 / properties / source_watermark

Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}

removedOutput schema / $defs / s9 / properties / staleness_seconds

Removed value: -{
-  "type": [
-    "integer",
-    "null"
-  ]
-}

addedOutput schema / $defs / s9 / properties / standard_metrics_complete
```
Added value: +{
+  "type": "boolean"
+}
```
addedOutput schema / $defs / s9 / properties / succeeded
```
Added value: +{
+  "type": "integer"
+}
```

addedOutput schema / $defs / s9 / properties / total_count

Added value: +{
+  "type": [
+    "integer",
+    "null"
+  ]
+}

addedOutput schema / $defs / s9 / properties / total_items
```
Added value: +{
+  "type": "integer"
+}
```
addedOutput schema / $defs / s9 / properties / total_pages
```
Added value: +{
+  "type": "integer"
+}
```

addedOutput schema / $defs / sa

Added value: +{
+  "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"
+}

removedOutput schema / $defs / sf

Removed value: -{
-  "properties": {
-    "category": {
-      "type": "string"
-    },
-    "code": {
-      "type": "string"
-    },
-    "message": {
-      "type": "string"
-    },
-    "retry_after_seconds": {
-      "type": [
-        "integer",
-        "null"
-      ]
-    },
-    "retryable": {
-      "type": "boolean"
-    },
-    "subcode": {
-      "type": "string"
-    }
-  },
-  "type": [
-    "null",
-    "object"
-  ]
-}

changedOutput schema / else / else / anyOf

Previous value: -[
-  {
-    "properties": {
-      "complete": {
-        "type": "boolean"
-      },
-      "results": {
-        "items": {
-          "properties": {
-            "data": {
-              "properties": {
-                "daily": {
-                  "$ref": "#/$defs/s1"
-                },
-                "funnel_events": {
-                  "items": {
-                    "type": "string"
-                  },
-                  "type": "array"
-                },
-                "funnel_semantics": {
-                  "$ref": "#/$defs/s7"
-                },
-                "items": {
-                  "$ref": "#/$defs/s1"
-                },
-                "meta": {
-                  "$ref": "#/$defs/s8"
-                },
-                "summary": {
-                  "$ref": "#/$defs/s6"
-                }
-              },
-              "type": [
-                "null",
-                "object"
-              ]
-            },
-            "error": {
-              "$ref": "#/$defs/sf"
-            },
-            "metrics_evidence": {
-              "properties": {
-                "source": {
-                  "type": "string"
-                },
-                "status": {
-                  "type": "string"
-                },
-                "zero_proven": {
-                  "type": "boolean"
-                }
-              },
-              "type": "object"
-            },
-            "ok": {
-              "type": "boolean"
-            },
-            "poll_after_ms": {
-              "type": [
-                "integer",
-                "null"
-              ]
-            },
-            "query_contract": {
-              "properties": {
-                "complete": {
-                  "type": "boolean"
-                },
-                "coverage": {
-                  "properties": {
-                    "account_coverage": {
-                      "properties": {
-                        "items": {
-                          "items": {
-                            "properties": {
-                              "ad_account_id": {
-                                "type": "string"
-                              },
-                              "complete": {
-                                "type": "boolean"
-                              },
-                              "source_observed_at": {
-                                "type": [
-                                  "string",
-                                  "null"
-                                ]
-                              }
-                            },
-                            "type": "object"
-                          },
-                          "maxItems": 20,
-                          "type": "array"
-                        },
-                        "latest_attempt_evaluated": {
-                          "const": false
-                        },
-                        "proves_ad_metrics": {
-                          "const": false
-                        },
-                        "requested_account_count": {
-                          "type": "integer"
-                        },
-                        "returned_count": {
-                          "type": "integer"
-                        },
-                        "source": {
-                          "const": "query_watermarks"
-                        },
-                        "truncated": {
-                          "type": "boolean"
-                        },
-                        "unverified_account_count": {
-                          "type": "integer"
-                        },
-                        "verified_account_count": {
-                          "type": "integer"
-                        }
-                      },
-                      "type": "object"
-                    },
-                    "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"
-                },
-                "source_watermark": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                }
-              },
-              "type": "object"
-            },
-            "scope": {
-              "$ref": "#/$defs/s0"
-            },
-            "scope_index": {
-              "type": "integer"
-            },
-            "status": {
-              "type": "string"
-            },
-            "task_ref": {
-              "type": [
-                "string",
-                "null"
-              ]
-            }
-          },
-          "required": [
-            "scope_index",
-            "scope",
-            "ok",
-            "status",
-            "data",
-            "query_contract",
-            "task_ref",
-            "poll_after_ms",
-            "error"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "schema_version": {
-        "type": "integer"
-      }
-    },
-    "required": [
-      "schema_version",
-      "complete",
-      "results"
-    ]
-  },
-  {
-    "properties": {
-      "data": {
-        "properties": {
-          "daily": {
-            "$ref": "#/$defs/s1"
-          },
-          "funnel_events": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "funnel_semantics": {
-            "$ref": "#/$defs/s7"
-          },
-          "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"
-                  ]
-                },
-                "budget_level": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "campaign_id": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "campaign_name": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "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"
-                  ]
-                },
-                "cpm": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "ctr": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "currency": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "daily_budget": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "data": {
-                  "properties": {
-                    "daily": {
-                      "$ref": "#/$defs/s1"
-                    },
-                    "effective_attribution": {
-                      "type": "string"
-                    },
-                    "funnel_events": {
-                      "items": {
-                        "type": "string"
-                      },
-                      "type": "array"
-                    },
-                    "funnel_semantics": {
-                      "$ref": "#/$defs/s7"
-                    },
-                    "items": {
-                      "$ref": "#/$defs/s1"
-                    },
-                    "meta": {
-                      "$ref": "#/$defs/s8"
-                    },
-                    "summary": {
-                      "$ref": "#/$defs/s6"
-                    }
-                  },
-                  "required": [
-                    "items",
-                    "meta"
-                  ],
-                  "type": [
-                    "null",
-                    "object"
-                  ]
-                },
-                "data_as_of_date": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "date": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "date_start": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "date_stop": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "delivery_issue_codes": {
-                  "items": {
-                    "type": "string"
-                  },
-                  "type": "array"
-                },
-                "delivery_status": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "effective_status": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "error": {
-                  "$ref": "#/$defs/sf"
-                },
-                "funnel": {
-                  "$ref": "#/$defs/s3"
-                },
-                "funnel_observation": {
-                  "$ref": "#/$defs/s4"
-                },
-                "id": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "impressions": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "lifetime_budget": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "money_unit": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "name": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "optimization_goal": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "product_type": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "reach": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "roas": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "scope": {
-                  "$ref": "#/$defs/s0"
-                },
-                "source_observed_at": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "spend": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "spend_usd": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "status": {
-                  "type": "string"
-                }
-              },
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "meta": {
-            "$ref": "#/$defs/s8"
-          },
-          "summary": {
-            "$ref": "#/$defs/s6"
-          }
-        },
-        "type": [
-          "null",
-          "object"
-        ]
-      },
-      "support_ref": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "warnings": {
-        "items": {
-          "properties": {
-            "code": {
-              "type": "string"
-            },
-            "message": {
-              "type": "string"
-            }
-          },
-          "type": "object"
-        },
-        "type": "array"
-      }
-    },
-    "required": [
-      "data",
-      "warnings"
-    ]
-  }
-]New value: +[
+  {
+    "properties": {
+      "complete": {
+        "type": "boolean"
+      },
+      "results": {
+        "items": {
+          "properties": {
+            "data": {
+              "properties": {
+                "daily": {
+                  "$ref": "#/$defs/s1"
+                },
+                "funnel_events": {
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
+                },
+                "funnel_semantics": {
+                  "$ref": "#/$defs/s8"
+                },
+                "items": {
+                  "$ref": "#/$defs/s1"
+                },
+                "meta": {
+                  "$ref": "#/$defs/s9"
+                },
+                "summary": {
+                  "$ref": "#/$defs/s7"
+                }
+              },
+              "type": [
+                "null",
+                "object"
+              ]
+            },
+            "error": {
+              "$ref": "#/$defs/s10"
+            },
+            "metrics_evidence": {
+              "properties": {
+                "source": {
+                  "type": "string"
+                },
+                "status": {
+                  "type": "string"
+                },
+                "zero_proven": {
+                  "type": "boolean"
+                }
+              },
+              "type": "object"
+            },
+            "ok": {
+              "type": "boolean"
+            },
+            "poll_after_ms": {
+              "type": [
+                "integer",
+                "null"
+              ]
+            },
+            "query_contract": {
+              "properties": {
+                "complete": {
+                  "type": "boolean"
+                },
+                "coverage": {
+                  "properties": {
+                    "account_coverage": {
+                      "properties": {
+                        "items": {
+                          "items": {
+                            "properties": {
+                              "ad_account_id": {
+                                "type": "string"
+                              },
+                              "complete": {
+                                "type": "boolean"
+                              },
+                              "source_observed_at": {
+                                "type": [
+                                  "string",
+                                  "null"
+                                ]
+                              }
+                            },
+                            "type": "object"
+                          },
+                          "maxItems": 20,
+                          "type": "array"
+                        },
+                        "latest_attempt_evaluated": {
+                          "const": false
+                        },
+                        "proves_ad_metrics": {
+                          "const": false
+                        },
+                        "requested_account_count": {
+                          "type": "integer"
+                        },
+                        "returned_count": {
+                          "type": "integer"
+                        },
+                        "source": {
+                          "const": "query_watermarks"
+                        },
+                        "truncated": {
+                          "type": "boolean"
+                        },
+                        "unverified_account_count": {
+                          "type": "integer"
+                        },
+                        "verified_account_count": {
+                          "type": "integer"
+                        }
+                      },
+                      "type": "object"
+                    },
+                    "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"
+                },
+                "source_watermark": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                }
+              },
+              "type": "object"
+            },
+            "scope": {
+              "$ref": "#/$defs/s0"
+            },
+            "scope_index": {
+              "type": "integer"
+            },
+            "status": {
+              "type": "string"
+            },
+            "task_ref": {
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          },
+          "required": [
+            "scope_index",
+            "scope",
+            "ok",
+            "status",
+            "data",
+            "query_contract",
+            "task_ref",
+            "poll_after_ms",
+            "error"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "schema_version": {
+        "type": "integer"
+      }
+    },
+    "required": [
+      "schema_version",
+      "complete",
+      "results"
+    ]
+  },
+  {
+    "properties": {
+      "data": {
+        "properties": {
+          "daily": {
+            "$ref": "#/$defs/s1"
+          },
+          "funnel_events": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "funnel_semantics": {
+            "$ref": "#/$defs/s8"
+          },
+          "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"
+                  ]
+                },
+                "budget_level": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "campaign_id": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "campaign_name": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "clicks": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "configured_status": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "configured_status_observed_at": {
+                  "$ref": "#/$defs/s4"
+                },
+                "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"
+                  ]
+                },
+                "currency": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "daily_budget": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "data": {
+                  "properties": {
+                    "daily": {
+                      "$ref": "#/$defs/s1"
+                    },
+                    "effective_attribution": {
+                      "type": "string"
+                    },
+                    "funnel_events": {
+                      "items": {
+                        "type": "string"
+                      },
+                      "type": "array"
+                    },
+                    "funnel_semantics": {
+                      "$ref": "#/$defs/s8"
+                    },
+                    "items": {
+                      "$ref": "#/$defs/s1"
+                    },
+                    "meta": {
+                      "$ref": "#/$defs/s9"
+                    },
+                    "summary": {
+                      "$ref": "#/$defs/s7"
+                    }
+                  },
+                  "required": [
+                    "items",
+                    "meta"
+                  ],
+                  "type": [
+                    "null",
+                    "object"
+                  ]
+                },
+                "data_as_of_date": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "date": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "date_start": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "date_stop": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "delivery_issue_codes": {
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
+                },
+                "delivery_status": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "effective_status": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "error": {
+                  "$ref": "#/$defs/s10"
+                },
+                "funnel": {
+                  "$ref": "#/$defs/s3"
+                },
+                "funnel_observation": {
+                  "$ref": "#/$defs/s5"
+                },
+                "id": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "impressions": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "lifetime_budget": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "money_unit": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "name": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "optimization_goal": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "product_type": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "reach": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "roas": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "scope": {
+                  "$ref": "#/$defs/s0"
+                },
+                "source_observed_at": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "spend": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "spend_usd": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "status": {
+                  "type": "string"
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "meta": {
+            "$ref": "#/$defs/s9"
+          },
+          "summary": {
+            "$ref": "#/$defs/s7"
+          }
+        },
+        "type": [
+          "null",
+          "object"
+        ]
+      },
+      "support_ref": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "warnings": {
+        "items": {
+          "properties": {
+            "code": {
+              "type": "string"
+            },
+            "message": {
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "data",
+      "warnings"
+    ]
+  }
+]

changedOutput schema / else / else / properties / meta / properties / data_freshness / $ref
```
Previous value: -"#/$defs/s9"New value: +"#/$defs/sa"
```
changedOutput schema / else / else / properties / read_evidence / properties / scopes / items / properties / funnel / additionalProperties / $ref
```
Previous value: -"#/$defs/s10"New value: +"#/$defs/s11"
```
changedOutput schema / else / else / properties / read_evidence / properties / scopes / items / properties / metrics / additionalProperties / $ref
```
Previous value: -"#/$defs/s10"New value: +"#/$defs/s11"
```

Changed3 schema fields changedSep 11, 2026

addedOutput schema / $defs / s10

Added value: +{
+  "properties": {
+    "can_report_stored_total": {
+      "type": "boolean"
+    },
+    "reason": {
+      "type": "string"
+    },
+    "zero_proven": {
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "can_report_stored_total",
+    "zero_proven",
+    "reason"
+  ],
+  "type": "object"
+}

addedOutput schema / $defs / s8 / properties / standard_metrics_complete
```
Added value: +{
+  "type": "boolean"
+}
```

addedOutput schema / else / else / properties / read_evidence

Added value: +{
+  "description": "Proofs apply independently to returned metrics and scope as stored/observed. A new read_ref is a call identifier, never a source watermark. False or missing proof means unknown, not zero. Fingerprints correlate requests/results in audits; they are not authorization or pagination tokens.",
+  "properties": {
+    "artifact_returned": {
+      "type": "boolean"
+    },
+    "configuration": {
+      "properties": {
+        "account_inventory_enumerated": {
+          "const": false
+        },
+        "all_campaigns_paused_proven": {
+          "const": false
+        },
+        "requested_ids_complete": {
+          "type": "boolean"
+        },
+        "scope": {
+          "const": "requested_entity_ids_only"
+        }
+      },
+      "type": "object"
+    },
+    "mmp": {
+      "properties": {
+        "can_report_scoped_totals": {
+          "type": "boolean"
+        },
+        "provider_cache_max_age_seconds": {
+          "const": 90
+        },
+        "reason": {
+          "type": "string"
+        },
+        "scope": {
+          "const": "linked_apps_queried_channels_and_windows"
+        },
+        "source_observed_at": {
+          "type": "null"
+        }
+      },
+      "type": "object"
+    },
+    "read_ref": {
+      "pattern": "^read_[0-9a-f]{32}$",
+      "type": "string"
+    },
+    "request_fingerprint": {
+      "type": "string"
+    },
+    "result_fingerprint": {
+      "type": "string"
+    },
+    "scopes": {
+      "items": {
+        "properties": {
+          "all_campaigns_paused_proven": {
+            "const": false
+          },
+          "funnel": {
+            "additionalProperties": {
+              "$ref": "#/$defs/s10"
+            },
+            "maxProperties": 32,
+            "type": "object"
+          },
+          "index": {
+            "type": "integer"
+          },
+          "inventory_anchor": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "inventory_coverage": {
+            "type": "string"
+          },
+          "inventory_source_observed_at": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "metrics": {
+            "additionalProperties": {
+              "$ref": "#/$defs/s10"
+            },
+            "type": "object"
+          },
+          "metrics_source_observed_at": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "range_complete": {
+            "type": [
+              "boolean",
+              "null"
+            ]
+          },
+          "scope": {
+            "const": "stored_query"
+          }
+        },
+        "type": "object"
+      },
+      "maxItems": 10,
+      "type": "array"
+    }
+  },
+  "required": [
+    "read_ref",
+    "request_fingerprint",
+    "result_fingerprint"
+  ],
+  "type": "object"
+}

Changed83 schema fields changedSep 11, 2026

addedOutput schema / $defs / s1 / items / properties / funnel_observation
```
Added value: +{
+  "$ref": "#/$defs/s4"
+}
```

removedOutput schema / $defs / s4 / properties / clicks

Removed value: -{
-  "type": [
-    "number",
-    "null"
-  ]
-}

removedOutput schema / $defs / s4 / properties / conversion_value

Removed value: -{
-  "type": [
-    "number",
-    "null"
-  ]
-}

removedOutput schema / $defs / s4 / properties / conversions

Removed value: -{
-  "type": [
-    "number",
-    "null"
-  ]
-}

removedOutput schema / $defs / s4 / properties / cpa

Removed value: -{
-  "type": [
-    "number",
-    "null"
-  ]
-}

removedOutput schema / $defs / s4 / properties / cpc

Removed value: -{
-  "type": [
-    "number",
-    "null"
-  ]
-}

removedOutput schema / $defs / s4 / properties / cpm

Removed value: -{
-  "type": [
-    "number",
-    "null"
-  ]
-}

removedOutput schema / $defs / s4 / properties / ctr

Removed value: -{
-  "type": [
-    "number",
-    "null"
-  ]
-}

removedOutput schema / $defs / s4 / properties / funnel
```
Removed value: -{
-  "$ref": "#/$defs/s3"
-}
```

removedOutput schema / $defs / s4 / properties / impressions

Removed value: -{
-  "type": [
-    "number",
-    "null"
-  ]
-}

addedOutput schema / $defs / s4 / properties / proves_source_coverage
```
Added value: +{
+  "const": false
+}
```
addedOutput schema / $defs / s4 / properties / proves_zero
```
Added value: +{
+  "const": false
+}
```

removedOutput schema / $defs / s4 / properties / reach

Removed value: -{
-  "type": [
-    "number",
-    "null"
-  ]
-}

removedOutput schema / $defs / s4 / properties / roas

Removed value: -{
-  "type": [
-    "number",
-    "null"
-  ]
-}

removedOutput schema / $defs / s4 / properties / spend

Removed value: -{
-  "type": [
-    "number",
-    "null"
-  ]
-}

removedOutput schema / $defs / s4 / properties / spend_usd

Removed value: -{
-  "type": [
-    "number",
-    "null"
-  ]
-}

addedOutput schema / $defs / s4 / properties / status

Added value: +{
+  "enum": [
+    "selected_events_returned",
+    "no_selected_events_returned",
+    "read_unverified",
+    "insights_unavailable"
+  ]
+}

removedOutput schema / $defs / s5

Removed value: -{
-  "properties": {
-    "coverage_requirement": {
-      "const": "verify_insights_and_source_coverage"
-    },
-    "missing_event_implies_missing_insights": {
-      "const": false
-    },
-    "missing_event_is_zero": {
-      "const": false
-    },
-    "representation": {
-      "const": "sparse"
-    }
-  },
-  "type": "object"
-}

removedOutput schema / $defs / s6 / properties / cache_hit
```
Removed value: -{
-  "type": "boolean"
-}
```

addedOutput schema / $defs / s6 / properties / clicks

Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}

removedOutput schema / $defs / s6 / properties / coalesced
```
Removed value: -{
-  "type": "boolean"
-}
```
removedOutput schema / $defs / s6 / properties / complete
```
Removed value: -{
-  "type": "boolean"
-}
```

addedOutput schema / $defs / s6 / properties / conversion_value

Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}

addedOutput schema / $defs / s6 / properties / conversions

Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}

addedOutput schema / $defs / s6 / properties / cpa

Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}

addedOutput schema / $defs / s6 / properties / cpc

Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}

addedOutput schema / $defs / s6 / properties / cpm

Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}

addedOutput schema / $defs / s6 / properties / ctr

Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}

removedOutput schema / $defs / s6 / properties / data_as_of_date

Removed value: -{
-  "type": [
-    "string",
-    "null"
-  ]
-}

removedOutput schema / $defs / s6 / properties / data_freshness
```
Removed value: -{
-  "$ref": "#/$defs/s7"
-}
```
removedOutput schema / $defs / s6 / properties / duration_ms
```
Removed value: -{
-  "type": "integer"
-}
```
removedOutput schema / $defs / s6 / properties / failed
```
Removed value: -{
-  "type": "integer"
-}
```

removedOutput schema / $defs / s6 / properties / freshness_warnings

Removed value: -{
-  "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"
-}

addedOutput schema / $defs / s6 / properties / funnel
```
Added value: +{
+  "$ref": "#/$defs/s3"
+}
```
removedOutput schema / $defs / s6 / properties / funnel_incomplete
```
Removed value: -{
-  "type": "boolean"
-}
```

removedOutput schema / $defs / s6 / properties / funnel_read_coverage

Removed value: -{
-  "properties": {
-    "complete": {
-      "type": "boolean"
-    },
-    "reason": {
-      "type": "string"
-    },
-    "source": {
-      "type": "string"
-    }
-  },
-  "type": "object"
-}

removedOutput schema / $defs / s6 / properties / has_more
```
Removed value: -{
-  "type": "boolean"
-}
```

addedOutput schema / $defs / s6 / properties / impressions

Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}

removedOutput schema / $defs / s6 / properties / item_count
```
Removed value: -{
-  "type": "integer"
-}
```

removedOutput schema / $defs / s6 / properties / limitations

Removed value: -{
-  "items": {
-    "type": "string"
-  },
-  "type": "array"
-}

removedOutput schema / $defs / s6 / properties / metrics_source_observed_at
```
Removed value: -{
-  "type": [
-    "string",
-    "null"
-  ]
-}
```

removedOutput schema / $defs / s6 / properties / missing_scopes

Removed value: -{
-  "items": {
-    "properties": {
-      "index": {
-        "type": "integer"
-      },
-      "status": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "index",
-      "status"
-    ],
-    "type": "object"
-  },
-  "type": "array"
-}

removedOutput schema / $defs / s6 / properties / next_cursor

Removed value: -{
-  "type": [
-    "string",
-    "null"
-  ]
-}

removedOutput schema / $defs / s6 / properties / page
```
Removed value: -{
-  "type": "integer"
-}
```
removedOutput schema / $defs / s6 / properties / page_size
```
Removed value: -{
-  "type": "integer"
-}
```

addedOutput schema / $defs / s6 / properties / reach

Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}

removedOutput schema / $defs / s6 / properties / refresh_reused
```
Removed value: -{
-  "type": "boolean"
-}
```
removedOutput schema / $defs / s6 / properties / returned_count
```
Removed value: -{
-  "type": "integer"
-}
```

addedOutput schema / $defs / s6 / properties / roas

Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}

removedOutput schema / $defs / s6 / properties / scope_count
```
Removed value: -{
-  "type": "integer"
-}
```
removedOutput schema / $defs / s6 / properties / source
```
Removed value: -{
-  "type": "string"
-}
```

removedOutput schema / $defs / s6 / properties / source_observed_at

Removed value: -{
-  "type": [
-    "string",
-    "null"
-  ]
-}

removedOutput schema / $defs / s6 / properties / source_row_count
```
Removed value: -{
-  "type": "integer"
-}
```
removedOutput schema / $defs / s6 / properties / source_truncated
```
Removed value: -{
-  "type": "boolean"
-}
```

removedOutput schema / $defs / s6 / properties / source_watermark

Removed value: -{
-  "type": [
-    "string",
-    "null"
-  ]
-}

addedOutput schema / $defs / s6 / properties / spend

Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}

addedOutput schema / $defs / s6 / properties / spend_usd

Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}

removedOutput schema / $defs / s6 / properties / succeeded
```
Removed value: -{
-  "type": "integer"
-}
```

removedOutput schema / $defs / s6 / properties / total_count

Removed value: -{
-  "type": [
-    "integer",
-    "null"
-  ]
-}

removedOutput schema / $defs / s6 / properties / total_items
```
Removed value: -{
-  "type": "integer"
-}
```
removedOutput schema / $defs / s6 / properties / total_pages
```
Removed value: -{
-  "type": "integer"
-}
```

addedOutput schema / $defs / s7 / properties / coverage_requirement

Added value: +{
+  "const": "verify_insights_and_source_coverage"
+}

addedOutput schema / $defs / s7 / properties / empty_funnel_interpretation

Added value: +{
+  "const": "no_selected_events_returned_not_zero_proof"
+}

removedOutput schema / $defs / s7 / properties / interval_min
```
Removed value: -{
-  "type": "integer"
-}
```
removedOutput schema / $defs / s7 / properties / label
```
Removed value: -{
-  "type": "string"
-}
```
removedOutput schema / $defs / s7 / properties / last_pull_failed_account_count
```
Removed value: -{
-  "type": [
-    "integer",
-    "null"
-  ]
-}
```
removedOutput schema / $defs / s7 / properties / last_pull_scope
```
Removed value: -{
-  "const": "workspace"
-}
```

removedOutput schema / $defs / s7 / properties / last_pull_status

Removed value: -{
-  "type": [
-    "string",
-    "null"
-  ]
-}

removedOutput schema / $defs / s7 / properties / last_pulled_at

Removed value: -{
-  "type": [
-    "string",
-    "null"
-  ]
-}

removedOutput schema / $defs / s7 / properties / max_staleness_min
```
Removed value: -{
-  "type": "integer"
-}
```
addedOutput schema / $defs / s7 / properties / missing_event_implies_missing_insights
```
Added value: +{
+  "const": false
+}
```
addedOutput schema / $defs / s7 / properties / missing_event_is_zero
```
Added value: +{
+  "const": false
+}
```

addedOutput schema / $defs / s7 / properties / read_coverage_scope

Added value: +{
+  "const": "query_result_not_upstream_ingestion"
+}

addedOutput schema / $defs / s7 / properties / representation
```
Added value: +{
+  "const": "sparse"
+}
```
removedOutput schema / $defs / s7 / properties / server_now_utc
```
Removed value: -{
-  "type": "string"
-}
```

removedOutput schema / $defs / s7 / properties / staleness_seconds

Removed value: -{
-  "type": [
-    "integer",
-    "null"
-  ]
-}

addedOutput schema / $defs / s8

Added value: +{
+  "properties": {
+    "cache_hit": {
+      "type": "boolean"
+    },
+    "coalesced": {
+      "type": "boolean"
+    },
+    "complete": {
+      "type": "boolean"
+    },
+    "data_as_of_date": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "data_freshness": {
+      "$ref": "#/$defs/s9"
+    },
+    "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"
+    },
+    "funnel_incomplete": {
+      "type": "boolean"
+    },
+    "funnel_read_coverage": {
+      "properties": {
+        "complete": {
+          "type": "boolean"
+        },
+        "reason": {
+          "type": "string"
+        },
+        "source": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "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"
+}

addedOutput schema / $defs / s9

Added value: +{
+  "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"
+}

removedOutput schema / $defs / sd

Removed value: -{
-  "properties": {
-    "category": {
-      "type": "string"
-    },
-    "code": {
-      "type": "string"
-    },
-    "message": {
-      "type": "string"
-    },
-    "retry_after_seconds": {
-      "type": [
-        "integer",
-        "null"
-      ]
-    },
-    "retryable": {
-      "type": "boolean"
-    },
-    "subcode": {
-      "type": "string"
-    }
-  },
-  "type": [
-    "null",
-    "object"
-  ]
-}

addedOutput schema / $defs / sf

Added value: +{
+  "properties": {
+    "category": {
+      "type": "string"
+    },
+    "code": {
+      "type": "string"
+    },
+    "message": {
+      "type": "string"
+    },
+    "retry_after_seconds": {
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "retryable": {
+      "type": "boolean"
+    },
+    "subcode": {
+      "type": "string"
+    }
+  },
+  "type": [
+    "null",
+    "object"
+  ]
+}

changedOutput schema / else / else / anyOf

Previous value: -[
-  {
-    "properties": {
-      "complete": {
-        "type": "boolean"
-      },
-      "results": {
-        "items": {
-          "properties": {
-            "data": {
-              "properties": {
-                "daily": {
-                  "$ref": "#/$defs/s1"
-                },
-                "funnel_events": {
-                  "items": {
-                    "type": "string"
-                  },
-                  "type": "array"
-                },
-                "funnel_semantics": {
-                  "$ref": "#/$defs/s5"
-                },
-                "items": {
-                  "$ref": "#/$defs/s1"
-                },
-                "meta": {
-                  "$ref": "#/$defs/s6"
-                },
-                "summary": {
-                  "$ref": "#/$defs/s4"
-                }
-              },
-              "type": [
-                "null",
-                "object"
-              ]
-            },
-            "error": {
-              "$ref": "#/$defs/sd"
-            },
-            "metrics_evidence": {
-              "properties": {
-                "source": {
-                  "type": "string"
-                },
-                "status": {
-                  "type": "string"
-                },
-                "zero_proven": {
-                  "type": "boolean"
-                }
-              },
-              "type": "object"
-            },
-            "ok": {
-              "type": "boolean"
-            },
-            "poll_after_ms": {
-              "type": [
-                "integer",
-                "null"
-              ]
-            },
-            "query_contract": {
-              "properties": {
-                "complete": {
-                  "type": "boolean"
-                },
-                "coverage": {
-                  "properties": {
-                    "account_coverage": {
-                      "properties": {
-                        "items": {
-                          "items": {
-                            "properties": {
-                              "ad_account_id": {
-                                "type": "string"
-                              },
-                              "complete": {
-                                "type": "boolean"
-                              },
-                              "source_observed_at": {
-                                "type": [
-                                  "string",
-                                  "null"
-                                ]
-                              }
-                            },
-                            "type": "object"
-                          },
-                          "maxItems": 20,
-                          "type": "array"
-                        },
-                        "latest_attempt_evaluated": {
-                          "const": false
-                        },
-                        "proves_ad_metrics": {
-                          "const": false
-                        },
-                        "requested_account_count": {
-                          "type": "integer"
-                        },
-                        "returned_count": {
-                          "type": "integer"
-                        },
-                        "source": {
-                          "const": "query_watermarks"
-                        },
-                        "truncated": {
-                          "type": "boolean"
-                        },
-                        "unverified_account_count": {
-                          "type": "integer"
-                        },
-                        "verified_account_count": {
-                          "type": "integer"
-                        }
-                      },
-                      "type": "object"
-                    },
-                    "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"
-                },
-                "source_watermark": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                }
-              },
-              "type": "object"
-            },
-            "scope": {
-              "$ref": "#/$defs/s0"
-            },
-            "scope_index": {
-              "type": "integer"
-            },
-            "status": {
-              "type": "string"
-            },
-            "task_ref": {
-              "type": [
-                "string",
-                "null"
-              ]
-            }
-          },
-          "required": [
-            "scope_index",
-            "scope",
-            "ok",
-            "status",
-            "data",
-            "query_contract",
-            "task_ref",
-            "poll_after_ms",
-            "error"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "schema_version": {
-        "type": "integer"
-      }
-    },
-    "required": [
-      "schema_version",
-      "complete",
-      "results"
-    ]
-  },
-  {
-    "properties": {
-      "data": {
-        "properties": {
-          "daily": {
-            "$ref": "#/$defs/s1"
-          },
-          "funnel_events": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "funnel_semantics": {
-            "$ref": "#/$defs/s5"
-          },
-          "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"
-                  ]
-                },
-                "budget_level": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "campaign_id": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "campaign_name": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "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"
-                  ]
-                },
-                "cpm": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "ctr": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "currency": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "daily_budget": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "data": {
-                  "properties": {
-                    "daily": {
-                      "$ref": "#/$defs/s1"
-                    },
-                    "effective_attribution": {
-                      "type": "string"
-                    },
-                    "funnel_events": {
-                      "items": {
-                        "type": "string"
-                      },
-                      "type": "array"
-                    },
-                    "funnel_semantics": {
-                      "$ref": "#/$defs/s5"
-                    },
-                    "items": {
-                      "$ref": "#/$defs/s1"
-                    },
-                    "meta": {
-                      "$ref": "#/$defs/s6"
-                    },
-                    "summary": {
-                      "$ref": "#/$defs/s4"
-                    }
-                  },
-                  "required": [
-                    "items",
-                    "meta"
-                  ],
-                  "type": [
-                    "null",
-                    "object"
-                  ]
-                },
-                "data_as_of_date": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "date": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "date_start": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "date_stop": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "delivery_issue_codes": {
-                  "items": {
-                    "type": "string"
-                  },
-                  "type": "array"
-                },
-                "delivery_status": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "effective_status": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "error": {
-                  "$ref": "#/$defs/sd"
-                },
-                "funnel": {
-                  "$ref": "#/$defs/s3"
-                },
-                "id": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "impressions": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "lifetime_budget": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "money_unit": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "name": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "optimization_goal": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "product_type": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "reach": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "roas": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "scope": {
-                  "$ref": "#/$defs/s0"
-                },
-                "source_observed_at": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "spend": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "spend_usd": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "status": {
-                  "type": "string"
-                }
-              },
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "meta": {
-            "$ref": "#/$defs/s6"
-          },
-          "summary": {
-            "$ref": "#/$defs/s4"
-          }
-        },
-        "type": [
-          "null",
-          "object"
-        ]
-      },
-      "support_ref": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "warnings": {
-        "items": {
-          "properties": {
-            "code": {
-              "type": "string"
-            },
-            "message": {
-              "type": "string"
-            }
-          },
-          "type": "object"
-        },
-        "type": "array"
-      }
-    },
-    "required": [
-      "data",
-      "warnings"
-    ]
-  }
-]New value: +[
+  {
+    "properties": {
+      "complete": {
+        "type": "boolean"
+      },
+      "results": {
+        "items": {
+          "properties": {
+            "data": {
+              "properties": {
+                "daily": {
+                  "$ref": "#/$defs/s1"
+                },
+                "funnel_events": {
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
+                },
+                "funnel_semantics": {
+                  "$ref": "#/$defs/s7"
+                },
+                "items": {
+                  "$ref": "#/$defs/s1"
+                },
+                "meta": {
+                  "$ref": "#/$defs/s8"
+                },
+                "summary": {
+                  "$ref": "#/$defs/s6"
+                }
+              },
+              "type": [
+                "null",
+                "object"
+              ]
+            },
+            "error": {
+              "$ref": "#/$defs/sf"
+            },
+            "metrics_evidence": {
+              "properties": {
+                "source": {
+                  "type": "string"
+                },
+                "status": {
+                  "type": "string"
+                },
+                "zero_proven": {
+                  "type": "boolean"
+                }
+              },
+              "type": "object"
+            },
+            "ok": {
+              "type": "boolean"
+            },
+            "poll_after_ms": {
+              "type": [
+                "integer",
+                "null"
+              ]
+            },
+            "query_contract": {
+              "properties": {
+                "complete": {
+                  "type": "boolean"
+                },
+                "coverage": {
+                  "properties": {
+                    "account_coverage": {
+                      "properties": {
+                        "items": {
+                          "items": {
+                            "properties": {
+                              "ad_account_id": {
+                                "type": "string"
+                              },
+                              "complete": {
+                                "type": "boolean"
+                              },
+                              "source_observed_at": {
+                                "type": [
+                                  "string",
+                                  "null"
+                                ]
+                              }
+                            },
+                            "type": "object"
+                          },
+                          "maxItems": 20,
+                          "type": "array"
+                        },
+                        "latest_attempt_evaluated": {
+                          "const": false
+                        },
+                        "proves_ad_metrics": {
+                          "const": false
+                        },
+                        "requested_account_count": {
+                          "type": "integer"
+                        },
+                        "returned_count": {
+                          "type": "integer"
+                        },
+                        "source": {
+                          "const": "query_watermarks"
+                        },
+                        "truncated": {
+                          "type": "boolean"
+                        },
+                        "unverified_account_count": {
+                          "type": "integer"
+                        },
+                        "verified_account_count": {
+                          "type": "integer"
+                        }
+                      },
+                      "type": "object"
+                    },
+                    "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"
+                },
+                "source_watermark": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                }
+              },
+              "type": "object"
+            },
+            "scope": {
+              "$ref": "#/$defs/s0"
+            },
+            "scope_index": {
+              "type": "integer"
+            },
+            "status": {
+              "type": "string"
+            },
+            "task_ref": {
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          },
+          "required": [
+            "scope_index",
+            "scope",
+            "ok",
+            "status",
+            "data",
+            "query_contract",
+            "task_ref",
+            "poll_after_ms",
+            "error"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "schema_version": {
+        "type": "integer"
+      }
+    },
+    "required": [
+      "schema_version",
+      "complete",
+      "results"
+    ]
+  },
+  {
+    "properties": {
+      "data": {
+        "properties": {
+          "daily": {
+            "$ref": "#/$defs/s1"
+          },
+          "funnel_events": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "funnel_semantics": {
+            "$ref": "#/$defs/s7"
+          },
+          "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"
+                  ]
+                },
+                "budget_level": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "campaign_id": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "campaign_name": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "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"
+                  ]
+                },
+                "cpm": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "ctr": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "currency": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "daily_budget": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "data": {
+                  "properties": {
+                    "daily": {
+                      "$ref": "#/$defs/s1"
+                    },
+                    "effective_attribution": {
+                      "type": "string"
+                    },
+                    "funnel_events": {
+                      "items": {
+                        "type": "string"
+                      },
+                      "type": "array"
+                    },
+                    "funnel_semantics": {
+                      "$ref": "#/$defs/s7"
+                    },
+                    "items": {
+                      "$ref": "#/$defs/s1"
+                    },
+                    "meta": {
+                      "$ref": "#/$defs/s8"
+                    },
+                    "summary": {
+                      "$ref": "#/$defs/s6"
+                    }
+                  },
+                  "required": [
+                    "items",
+                    "meta"
+                  ],
+                  "type": [
+                    "null",
+                    "object"
+                  ]
+                },
+                "data_as_of_date": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "date": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "date_start": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "date_stop": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "delivery_issue_codes": {
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
+                },
+                "delivery_status": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "effective_status": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "error": {
+                  "$ref": "#/$defs/sf"
+                },
+                "funnel": {
+                  "$ref": "#/$defs/s3"
+                },
+                "funnel_observation": {
+                  "$ref": "#/$defs/s4"
+                },
+                "id": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "impressions": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "lifetime_budget": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "money_unit": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "name": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "optimization_goal": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "product_type": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "reach": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "roas": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "scope": {
+                  "$ref": "#/$defs/s0"
+                },
+                "source_observed_at": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "spend": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "spend_usd": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "status": {
+                  "type": "string"
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "meta": {
+            "$ref": "#/$defs/s8"
+          },
+          "summary": {
+            "$ref": "#/$defs/s6"
+          }
+        },
+        "type": [
+          "null",
+          "object"
+        ]
+      },
+      "support_ref": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "warnings": {
+        "items": {
+          "properties": {
+            "code": {
+              "type": "string"
+            },
+            "message": {
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "data",
+      "warnings"
+    ]
+  }
+]

changedOutput schema / else / else / properties / meta / properties / data_freshness / $ref
```
Previous value: -"#/$defs/s7"New value: +"#/$defs/s9"
```

addedOutput schema / else / else / properties / workspace_ref

Added value: +{
+  "description": "Opaque workspace comparison hint; not an authorization credential.",
+  "pattern": "^workspace_[0-9a-f]{32}$",
+  "type": "string"
+}

Changed1 schema field changedSep 10, 2026

changedInput schema / $defs / 0 / oneOf

Previous value: -[
-  {
-    "properties": {
-      "ad_account_id": {
-        "type": "null"
-      }
-    },
-    "required": [
-      "product_ref"
-    ]
-  },
-  {
-    "properties": {
-      "product_ref": {
-        "type": "null"
-      }
-    },
-    "required": [
-      "ad_account_id"
-    ]
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "ad_account_id": {
+        "type": "null"
+      },
+      "product_ref": {
+        "maxLength": 165,
+        "minLength": 6,
+        "pattern": "^prod_[A-Za-z0-9_-]{1,160}$",
+        "type": "string"
+      }
+    },
+    "required": [
+      "product_ref"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "ad_account_id": {
+        "maxLength": 36,
+        "minLength": 1,
+        "pattern": "^(?:act_)?[0-9]{1,32}$",
+        "type": "string"
+      },
+      "product_ref": {
+        "type": "null"
+      }
+    },
+    "required": [
+      "ad_account_id"
+    ],
+    "type": "object"
+  }
+]

Changed2 schema fields changedSep 10, 2026

addedOutput schema / $defs / s7 / properties / last_pull_scope
```
Added value: +{
+  "const": "workspace"
+}
```

changedOutput schema / else / else / anyOf

Previous value: -[
-  {
-    "properties": {
-      "complete": {
-        "type": "boolean"
-      },
-      "results": {
-        "items": {
-          "properties": {
-            "data": {
-              "properties": {
-                "daily": {
-                  "$ref": "#/$defs/s1"
-                },
-                "funnel_events": {
-                  "items": {
-                    "type": "string"
-                  },
-                  "type": "array"
-                },
-                "funnel_semantics": {
-                  "$ref": "#/$defs/s5"
-                },
-                "items": {
-                  "$ref": "#/$defs/s1"
-                },
-                "meta": {
-                  "$ref": "#/$defs/s6"
-                },
-                "summary": {
-                  "$ref": "#/$defs/s4"
-                }
-              },
-              "type": [
-                "null",
-                "object"
-              ]
-            },
-            "error": {
-              "$ref": "#/$defs/sd"
-            },
-            "metrics_evidence": {
-              "properties": {
-                "source": {
-                  "type": "string"
-                },
-                "status": {
-                  "type": "string"
-                },
-                "zero_proven": {
-                  "type": "boolean"
-                }
-              },
-              "type": "object"
-            },
-            "ok": {
-              "type": "boolean"
-            },
-            "poll_after_ms": {
-              "type": [
-                "integer",
-                "null"
-              ]
-            },
-            "query_contract": {
-              "properties": {
-                "complete": {
-                  "type": "boolean"
-                },
-                "coverage": {
-                  "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"
-                },
-                "source_watermark": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                }
-              },
-              "type": "object"
-            },
-            "scope": {
-              "$ref": "#/$defs/s0"
-            },
-            "scope_index": {
-              "type": "integer"
-            },
-            "status": {
-              "type": "string"
-            },
-            "task_ref": {
-              "type": [
-                "string",
-                "null"
-              ]
-            }
-          },
-          "required": [
-            "scope_index",
-            "scope",
-            "ok",
-            "status",
-            "data",
-            "query_contract",
-            "task_ref",
-            "poll_after_ms",
-            "error"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "schema_version": {
-        "type": "integer"
-      }
-    },
-    "required": [
-      "schema_version",
-      "complete",
-      "results"
-    ]
-  },
-  {
-    "properties": {
-      "data": {
-        "properties": {
-          "daily": {
-            "$ref": "#/$defs/s1"
-          },
-          "funnel_events": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "funnel_semantics": {
-            "$ref": "#/$defs/s5"
-          },
-          "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"
-                  ]
-                },
-                "budget_level": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "campaign_id": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "campaign_name": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "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"
-                  ]
-                },
-                "cpm": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "ctr": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "currency": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "daily_budget": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "data": {
-                  "properties": {
-                    "daily": {
-                      "$ref": "#/$defs/s1"
-                    },
-                    "effective_attribution": {
-                      "type": "string"
-                    },
-                    "funnel_events": {
-                      "items": {
-                        "type": "string"
-                      },
-                      "type": "array"
-                    },
-                    "funnel_semantics": {
-                      "$ref": "#/$defs/s5"
-                    },
-                    "items": {
-                      "$ref": "#/$defs/s1"
-                    },
-                    "meta": {
-                      "$ref": "#/$defs/s6"
-                    },
-                    "summary": {
-                      "$ref": "#/$defs/s4"
-                    }
-                  },
-                  "required": [
-                    "items",
-                    "meta"
-                  ],
-                  "type": [
-                    "null",
-                    "object"
-                  ]
-                },
-                "data_as_of_date": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "date": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "date_start": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "date_stop": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "delivery_issue_codes": {
-                  "items": {
-                    "type": "string"
-                  },
-                  "type": "array"
-                },
-                "delivery_status": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "effective_status": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "error": {
-                  "$ref": "#/$defs/sd"
-                },
-                "funnel": {
-                  "$ref": "#/$defs/s3"
-                },
-                "id": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "impressions": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "lifetime_budget": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "money_unit": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "name": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "optimization_goal": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "product_type": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "reach": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "roas": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "scope": {
-                  "$ref": "#/$defs/s0"
-                },
-                "source_observed_at": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "spend": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "spend_usd": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "status": {
-                  "type": "string"
-                }
-              },
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "meta": {
-            "$ref": "#/$defs/s6"
-          },
-          "summary": {
-            "$ref": "#/$defs/s4"
-          }
-        },
-        "type": [
-          "null",
-          "object"
-        ]
-      },
-      "support_ref": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "warnings": {
-        "items": {
-          "properties": {
-            "code": {
-              "type": "string"
-            },
-            "message": {
-              "type": "string"
-            }
-          },
-          "type": "object"
-        },
-        "type": "array"
-      }
-    },
-    "required": [
-      "data",
-      "warnings"
-    ]
-  }
-]New value: +[
+  {
+    "properties": {
+      "complete": {
+        "type": "boolean"
+      },
+      "results": {
+        "items": {
+          "properties": {
+            "data": {
+              "properties": {
+                "daily": {
+                  "$ref": "#/$defs/s1"
+                },
+                "funnel_events": {
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
+                },
+                "funnel_semantics": {
+                  "$ref": "#/$defs/s5"
+                },
+                "items": {
+                  "$ref": "#/$defs/s1"
+                },
+                "meta": {
+                  "$ref": "#/$defs/s6"
+                },
+                "summary": {
+                  "$ref": "#/$defs/s4"
+                }
+              },
+              "type": [
+                "null",
+                "object"
+              ]
+            },
+            "error": {
+              "$ref": "#/$defs/sd"
+            },
+            "metrics_evidence": {
+              "properties": {
+                "source": {
+                  "type": "string"
+                },
+                "status": {
+                  "type": "string"
+                },
+                "zero_proven": {
+                  "type": "boolean"
+                }
+              },
+              "type": "object"
+            },
+            "ok": {
+              "type": "boolean"
+            },
+            "poll_after_ms": {
+              "type": [
+                "integer",
+                "null"
+              ]
+            },
+            "query_contract": {
+              "properties": {
+                "complete": {
+                  "type": "boolean"
+                },
+                "coverage": {
+                  "properties": {
+                    "account_coverage": {
+                      "properties": {
+                        "items": {
+                          "items": {
+                            "properties": {
+                              "ad_account_id": {
+                                "type": "string"
+                              },
+                              "complete": {
+                                "type": "boolean"
+                              },
+                              "source_observed_at": {
+                                "type": [
+                                  "string",
+                                  "null"
+                                ]
+                              }
+                            },
+                            "type": "object"
+                          },
+                          "maxItems": 20,
+                          "type": "array"
+                        },
+                        "latest_attempt_evaluated": {
+                          "const": false
+                        },
+                        "proves_ad_metrics": {
+                          "const": false
+                        },
+                        "requested_account_count": {
+                          "type": "integer"
+                        },
+                        "returned_count": {
+                          "type": "integer"
+                        },
+                        "source": {
+                          "const": "query_watermarks"
+                        },
+                        "truncated": {
+                          "type": "boolean"
+                        },
+                        "unverified_account_count": {
+                          "type": "integer"
+                        },
+                        "verified_account_count": {
+                          "type": "integer"
+                        }
+                      },
+                      "type": "object"
+                    },
+                    "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"
+                },
+                "source_watermark": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                }
+              },
+              "type": "object"
+            },
+            "scope": {
+              "$ref": "#/$defs/s0"
+            },
+            "scope_index": {
+              "type": "integer"
+            },
+            "status": {
+              "type": "string"
+            },
+            "task_ref": {
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          },
+          "required": [
+            "scope_index",
+            "scope",
+            "ok",
+            "status",
+            "data",
+            "query_contract",
+            "task_ref",
+            "poll_after_ms",
+            "error"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "schema_version": {
+        "type": "integer"
+      }
+    },
+    "required": [
+      "schema_version",
+      "complete",
+      "results"
+    ]
+  },
+  {
+    "properties": {
+      "data": {
+        "properties": {
+          "daily": {
+            "$ref": "#/$defs/s1"
+          },
+          "funnel_events": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "funnel_semantics": {
+            "$ref": "#/$defs/s5"
+          },
+          "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"
+                  ]
+                },
+                "budget_level": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "campaign_id": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "campaign_name": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "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"
+                  ]
+                },
+                "cpm": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "ctr": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "currency": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "daily_budget": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "data": {
+                  "properties": {
+                    "daily": {
+                      "$ref": "#/$defs/s1"
+                    },
+                    "effective_attribution": {
+                      "type": "string"
+                    },
+                    "funnel_events": {
+                      "items": {
+                        "type": "string"
+                      },
+                      "type": "array"
+                    },
+                    "funnel_semantics": {
+                      "$ref": "#/$defs/s5"
+                    },
+                    "items": {
+                      "$ref": "#/$defs/s1"
+                    },
+                    "meta": {
+                      "$ref": "#/$defs/s6"
+                    },
+                    "summary": {
+                      "$ref": "#/$defs/s4"
+                    }
+                  },
+                  "required": [
+                    "items",
+                    "meta"
+                  ],
+                  "type": [
+                    "null",
+                    "object"
+                  ]
+                },
+                "data_as_of_date": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "date": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "date_start": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "date_stop": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "delivery_issue_codes": {
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
+                },
+                "delivery_status": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "effective_status": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "error": {
+                  "$ref": "#/$defs/sd"
+                },
+                "funnel": {
+                  "$ref": "#/$defs/s3"
+                },
+                "id": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "impressions": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "lifetime_budget": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "money_unit": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "name": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "optimization_goal": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "product_type": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "reach": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "roas": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "scope": {
+                  "$ref": "#/$defs/s0"
+                },
+                "source_observed_at": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "spend": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "spend_usd": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "status": {
+                  "type": "string"
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "meta": {
+            "$ref": "#/$defs/s6"
+          },
+          "summary": {
+            "$ref": "#/$defs/s4"
+          }
+        },
+        "type": [
+          "null",
+          "object"
+        ]
+      },
+      "support_ref": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "warnings": {
+        "items": {
+          "properties": {
+            "code": {
+              "type": "string"
+            },
+            "message": {
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "data",
+      "warnings"
+    ]
+  }
+]

Changed55 schema fields changedSep 10, 2026

addedOutput schema / $defs / s1 / items / properties / funnel / $ref
```
Added value: +"#/$defs/s3"
```
removedOutput schema / $defs / s1 / items / properties / funnel / additionalProperties
```
Removed value: -{
-  "type": "number"
-}
```
removedOutput schema / $defs / s1 / items / properties / funnel / type
```
Removed value: -"object"
```

addedOutput schema / $defs / s3 / additionalProperties

Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}

removedOutput schema / $defs / s3 / properties

Removed value: -{
-  "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"
-    ]
-  }
-}

removedOutput schema / $defs / s4 / properties / cache_hit
```
Removed value: -{
-  "type": "boolean"
-}
```

addedOutput schema / $defs / s4 / properties / clicks

Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}

removedOutput schema / $defs / s4 / properties / coalesced
```
Removed value: -{
-  "type": "boolean"
-}
```
removedOutput schema / $defs / s4 / properties / complete
```
Removed value: -{
-  "type": "boolean"
-}
```

addedOutput schema / $defs / s4 / properties / conversion_value

Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}

addedOutput schema / $defs / s4 / properties / conversions

Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}

addedOutput schema / $defs / s4 / properties / cpa

Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}

addedOutput schema / $defs / s4 / properties / cpc

Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}

addedOutput schema / $defs / s4 / properties / cpm

Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}

addedOutput schema / $defs / s4 / properties / ctr

Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}

removedOutput schema / $defs / s4 / properties / data_as_of_date

Removed value: -{
-  "type": [
-    "string",
-    "null"
-  ]
-}

removedOutput schema / $defs / s4 / properties / data_freshness

Removed value: -{
-  "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"
-}

removedOutput schema / $defs / s4 / properties / duration_ms
```
Removed value: -{
-  "type": "integer"
-}
```
removedOutput schema / $defs / s4 / properties / failed
```
Removed value: -{
-  "type": "integer"
-}
```

removedOutput schema / $defs / s4 / properties / freshness_warnings

Removed value: -{
-  "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"
-}

addedOutput schema / $defs / s4 / properties / funnel
```
Added value: +{
+  "$ref": "#/$defs/s3"
+}
```
removedOutput schema / $defs / s4 / properties / has_more
```
Removed value: -{
-  "type": "boolean"
-}
```

addedOutput schema / $defs / s4 / properties / impressions

Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}

removedOutput schema / $defs / s4 / properties / item_count
```
Removed value: -{
-  "type": "integer"
-}
```

removedOutput schema / $defs / s4 / properties / limitations

Removed value: -{
-  "items": {
-    "type": "string"
-  },
-  "type": "array"
-}

removedOutput schema / $defs / s4 / properties / metrics_source_observed_at
```
Removed value: -{
-  "type": [
-    "string",
-    "null"
-  ]
-}
```

removedOutput schema / $defs / s4 / properties / missing_scopes

Removed value: -{
-  "items": {
-    "properties": {
-      "index": {
-        "type": "integer"
-      },
-      "status": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "index",
-      "status"
-    ],
-    "type": "object"
-  },
-  "type": "array"
-}

removedOutput schema / $defs / s4 / properties / next_cursor

Removed value: -{
-  "type": [
-    "string",
-    "null"
-  ]
-}

removedOutput schema / $defs / s4 / properties / page
```
Removed value: -{
-  "type": "integer"
-}
```
removedOutput schema / $defs / s4 / properties / page_size
```
Removed value: -{
-  "type": "integer"
-}
```

addedOutput schema / $defs / s4 / properties / reach

Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}

removedOutput schema / $defs / s4 / properties / refresh_reused
```
Removed value: -{
-  "type": "boolean"
-}
```
removedOutput schema / $defs / s4 / properties / returned_count
```
Removed value: -{
-  "type": "integer"
-}
```

addedOutput schema / $defs / s4 / properties / roas

Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}

removedOutput schema / $defs / s4 / properties / scope_count
```
Removed value: -{
-  "type": "integer"
-}
```
removedOutput schema / $defs / s4 / properties / source
```
Removed value: -{
-  "type": "string"
-}
```

removedOutput schema / $defs / s4 / properties / source_observed_at

Removed value: -{
-  "type": [
-    "string",
-    "null"
-  ]
-}

removedOutput schema / $defs / s4 / properties / source_row_count
```
Removed value: -{
-  "type": "integer"
-}
```
removedOutput schema / $defs / s4 / properties / source_truncated
```
Removed value: -{
-  "type": "boolean"
-}
```

removedOutput schema / $defs / s4 / properties / source_watermark

Removed value: -{
-  "type": [
-    "string",
-    "null"
-  ]
-}

addedOutput schema / $defs / s4 / properties / spend

Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}

addedOutput schema / $defs / s4 / properties / spend_usd

Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}

removedOutput schema / $defs / s4 / properties / succeeded
```
Removed value: -{
-  "type": "integer"
-}
```

removedOutput schema / $defs / s4 / properties / total_count

Removed value: -{
-  "type": [
-    "integer",
-    "null"
-  ]
-}

removedOutput schema / $defs / s4 / properties / total_items
```
Removed value: -{
-  "type": "integer"
-}
```
removedOutput schema / $defs / s4 / properties / total_pages
```
Removed value: -{
-  "type": "integer"
-}
```

addedOutput schema / $defs / s5

Added value: +{
+  "properties": {
+    "coverage_requirement": {
+      "const": "verify_insights_and_source_coverage"
+    },
+    "missing_event_implies_missing_insights": {
+      "const": false
+    },
+    "missing_event_is_zero": {
+      "const": false
+    },
+    "representation": {
+      "const": "sparse"
+    }
+  },
+  "type": "object"
+}

addedOutput schema / $defs / s6

Added value: +{
+  "properties": {
+    "cache_hit": {
+      "type": "boolean"
+    },
+    "coalesced": {
+      "type": "boolean"
+    },
+    "complete": {
+      "type": "boolean"
+    },
+    "data_as_of_date": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "data_freshness": {
+      "$ref": "#/$defs/s7"
+    },
+    "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"
+    },
+    "funnel_incomplete": {
+      "type": "boolean"
+    },
+    "funnel_read_coverage": {
+      "properties": {
+        "complete": {
+          "type": "boolean"
+        },
+        "reason": {
+          "type": "string"
+        },
+        "source": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "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"
+}

addedOutput schema / $defs / s7

Added value: +{
+  "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"
+}

removedOutput schema / $defs / sa

Removed value: -{
-  "properties": {
-    "category": {
-      "type": "string"
-    },
-    "code": {
-      "type": "string"
-    },
-    "message": {
-      "type": "string"
-    },
-    "retry_after_seconds": {
-      "type": [
-        "integer",
-        "null"
-      ]
-    },
-    "retryable": {
-      "type": "boolean"
-    },
-    "subcode": {
-      "type": "string"
-    }
-  },
-  "type": [
-    "null",
-    "object"
-  ]
-}

addedOutput schema / $defs / sd

Added value: +{
+  "properties": {
+    "category": {
+      "type": "string"
+    },
+    "code": {
+      "type": "string"
+    },
+    "message": {
+      "type": "string"
+    },
+    "retry_after_seconds": {
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "retryable": {
+      "type": "boolean"
+    },
+    "subcode": {
+      "type": "string"
+    }
+  },
+  "type": [
+    "null",
+    "object"
+  ]
+}

changedOutput schema / else / else / anyOf

Previous value: -[
-  {
-    "properties": {
-      "complete": {
-        "type": "boolean"
-      },
-      "results": {
-        "items": {
-          "properties": {
-            "data": {
-              "properties": {
-                "daily": {
-                  "$ref": "#/$defs/s1"
-                },
-                "items": {
-                  "$ref": "#/$defs/s1"
-                },
-                "meta": {
-                  "$ref": "#/$defs/s4"
-                },
-                "summary": {
-                  "$ref": "#/$defs/s3"
-                }
-              },
-              "type": [
-                "null",
-                "object"
-              ]
-            },
-            "error": {
-              "$ref": "#/$defs/sa"
-            },
-            "metrics_evidence": {
-              "properties": {
-                "source": {
-                  "type": "string"
-                },
-                "status": {
-                  "type": "string"
-                },
-                "zero_proven": {
-                  "type": "boolean"
-                }
-              },
-              "type": "object"
-            },
-            "ok": {
-              "type": "boolean"
-            },
-            "poll_after_ms": {
-              "type": [
-                "integer",
-                "null"
-              ]
-            },
-            "query_contract": {
-              "properties": {
-                "complete": {
-                  "type": "boolean"
-                },
-                "coverage": {
-                  "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"
-                },
-                "source_watermark": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                }
-              },
-              "type": "object"
-            },
-            "scope": {
-              "$ref": "#/$defs/s0"
-            },
-            "scope_index": {
-              "type": "integer"
-            },
-            "status": {
-              "type": "string"
-            },
-            "task_ref": {
-              "type": [
-                "string",
-                "null"
-              ]
-            }
-          },
-          "required": [
-            "scope_index",
-            "scope",
-            "ok",
-            "status",
-            "data",
-            "query_contract",
-            "task_ref",
-            "poll_after_ms",
-            "error"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "schema_version": {
-        "type": "integer"
-      }
-    },
-    "required": [
-      "schema_version",
-      "complete",
-      "results"
-    ]
-  },
-  {
-    "properties": {
-      "data": {
-        "properties": {
-          "daily": {
-            "$ref": "#/$defs/s1"
-          },
-          "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"
-                  ]
-                },
-                "budget_level": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "campaign_id": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "campaign_name": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "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"
-                  ]
-                },
-                "cpm": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "ctr": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "currency": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "daily_budget": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "data": {
-                  "properties": {
-                    "daily": {
-                      "$ref": "#/$defs/s1"
-                    },
-                    "effective_attribution": {
-                      "type": "string"
-                    },
-                    "funnel_events": {
-                      "items": {
-                        "type": "string"
-                      },
-                      "type": "array"
-                    },
-                    "items": {
-                      "$ref": "#/$defs/s1"
-                    },
-                    "meta": {
-                      "$ref": "#/$defs/s4"
-                    },
-                    "summary": {
-                      "$ref": "#/$defs/s3"
-                    }
-                  },
-                  "required": [
-                    "items",
-                    "meta"
-                  ],
-                  "type": [
-                    "null",
-                    "object"
-                  ]
-                },
-                "data_as_of_date": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "date": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "date_start": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "date_stop": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "delivery_issue_codes": {
-                  "items": {
-                    "type": "string"
-                  },
-                  "type": "array"
-                },
-                "delivery_status": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "effective_status": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "error": {
-                  "$ref": "#/$defs/sa"
-                },
-                "funnel": {
-                  "additionalProperties": {
-                    "type": "number"
-                  },
-                  "type": "object"
-                },
-                "id": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "impressions": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "lifetime_budget": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "money_unit": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "name": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "optimization_goal": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "product_type": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "reach": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "roas": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "scope": {
-                  "$ref": "#/$defs/s0"
-                },
-                "source_observed_at": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "spend": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "spend_usd": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "status": {
-                  "type": "string"
-                }
-              },
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "meta": {
-            "$ref": "#/$defs/s4"
-          },
-          "summary": {
-            "$ref": "#/$defs/s3"
-          }
-        },
-        "type": [
-          "null",
-          "object"
-        ]
-      },
-      "support_ref": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "warnings": {
-        "items": {
-          "properties": {
-            "code": {
-              "type": "string"
-            },
-            "message": {
-              "type": "string"
-            }
-          },
-          "type": "object"
-        },
-        "type": "array"
-      }
-    },
-    "required": [
-      "data",
-      "warnings"
-    ]
-  }
-]New value: +[
+  {
+    "properties": {
+      "complete": {
+        "type": "boolean"
+      },
+      "results": {
+        "items": {
+          "properties": {
+            "data": {
+              "properties": {
+                "daily": {
+                  "$ref": "#/$defs/s1"
+                },
+                "funnel_events": {
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
+                },
+                "funnel_semantics": {
+                  "$ref": "#/$defs/s5"
+                },
+                "items": {
+                  "$ref": "#/$defs/s1"
+                },
+                "meta": {
+                  "$ref": "#/$defs/s6"
+                },
+                "summary": {
+                  "$ref": "#/$defs/s4"
+                }
+              },
+              "type": [
+                "null",
+                "object"
+              ]
+            },
+            "error": {
+              "$ref": "#/$defs/sd"
+            },
+            "metrics_evidence": {
+              "properties": {
+                "source": {
+                  "type": "string"
+                },
+                "status": {
+                  "type": "string"
+                },
+                "zero_proven": {
+                  "type": "boolean"
+                }
+              },
+              "type": "object"
+            },
+            "ok": {
+              "type": "boolean"
+            },
+            "poll_after_ms": {
+              "type": [
+                "integer",
+                "null"
+              ]
+            },
+            "query_contract": {
+              "properties": {
+                "complete": {
+                  "type": "boolean"
+                },
+                "coverage": {
+                  "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"
+                },
+                "source_watermark": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                }
+              },
+              "type": "object"
+            },
+            "scope": {
+              "$ref": "#/$defs/s0"
+            },
+            "scope_index": {
+              "type": "integer"
+            },
+            "status": {
+              "type": "string"
+            },
+            "task_ref": {
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          },
+          "required": [
+            "scope_index",
+            "scope",
+            "ok",
+            "status",
+            "data",
+            "query_contract",
+            "task_ref",
+            "poll_after_ms",
+            "error"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "schema_version": {
+        "type": "integer"
+      }
+    },
+    "required": [
+      "schema_version",
+      "complete",
+      "results"
+    ]
+  },
+  {
+    "properties": {
+      "data": {
+        "properties": {
+          "daily": {
+            "$ref": "#/$defs/s1"
+          },
+          "funnel_events": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "funnel_semantics": {
+            "$ref": "#/$defs/s5"
+          },
+          "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"
+                  ]
+                },
+                "budget_level": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "campaign_id": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "campaign_name": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "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"
+                  ]
+                },
+                "cpm": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "ctr": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "currency": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "daily_budget": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "data": {
+                  "properties": {
+                    "daily": {
+                      "$ref": "#/$defs/s1"
+                    },
+                    "effective_attribution": {
+                      "type": "string"
+                    },
+                    "funnel_events": {
+                      "items": {
+                        "type": "string"
+                      },
+                      "type": "array"
+                    },
+                    "funnel_semantics": {
+                      "$ref": "#/$defs/s5"
+                    },
+                    "items": {
+                      "$ref": "#/$defs/s1"
+                    },
+                    "meta": {
+                      "$ref": "#/$defs/s6"
+                    },
+                    "summary": {
+                      "$ref": "#/$defs/s4"
+                    }
+                  },
+                  "required": [
+                    "items",
+                    "meta"
+                  ],
+                  "type": [
+                    "null",
+                    "object"
+                  ]
+                },
+                "data_as_of_date": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "date": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "date_start": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "date_stop": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "delivery_issue_codes": {
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
+                },
+                "delivery_status": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "effective_status": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "error": {
+                  "$ref": "#/$defs/sd"
+                },
+                "funnel": {
+                  "$ref": "#/$defs/s3"
+                },
+                "id": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "impressions": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "lifetime_budget": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "money_unit": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "name": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "optimization_goal": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "product_type": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "reach": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "roas": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "scope": {
+                  "$ref": "#/$defs/s0"
+                },
+                "source_observed_at": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "spend": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "spend_usd": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "status": {
+                  "type": "string"
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "meta": {
+            "$ref": "#/$defs/s6"
+          },
+          "summary": {
+            "$ref": "#/$defs/s4"
+          }
+        },
+        "type": [
+          "null",
+          "object"
+        ]
+      },
+      "support_ref": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "warnings": {
+        "items": {
+          "properties": {
+            "code": {
+              "type": "string"
+            },
+            "message": {
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "data",
+      "warnings"
+    ]
+  }
+]

removedOutput schema / else / else / properties / meta / $ref
```
Removed value: -"#/$defs/s4"
```

addedOutput schema / else / else / properties / meta / properties

Added value: +{
+  "cache_hit": {
+    "type": "boolean"
+  },
+  "coalesced": {
+    "type": "boolean"
+  },
+  "complete": {
+    "type": "boolean"
+  },
+  "data_as_of_date": {
+    "type": [
+      "string",
+      "null"
+    ]
+  },
+  "data_freshness": {
+    "$ref": "#/$defs/s7"
+  },
+  "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"
+  }
+}

addedOutput schema / else / else / properties / meta / type
```
Added value: +"object"
```

First observedSep 9, 2026

TDQS

B3.1/5.0

Behavior4/5

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

Annotations only cover the safety profile (readOnlyHint=false, destructiveHint=false); the description adds genuinely useful behavior not in the schema: cached vs. fresh modes may queue refresh tasks, polling semantics for task_ref, and the warning that totals are only valid when complete and coverage are set. These are real operational constraints that go beyond the annotations.

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

Conciseness3/5

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

The description is terse and packs several distinct facts into four sentences, but the concepts (batch mode, request vs. direct fields, cached vs. fresh, polling, completeness) run together without clear structure. It's compact but not well-organized for a tool this complex.

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?

Given 22 parameters, no schema coverage, and an output schema the description needn't explain, the description covers the workflow (query then poll then check completeness) reasonably but omits the meaning of many inputs. An output schema exists, so return-value detail is rightly omitted; still, the parameter side is thin for a tool this large.

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 22 parameters, so the description must carry the burden, but it only touches a few fields (group_by, dates, scope/scopes, request, consistency modes implicitly). Critical parameters such as filters, dedupe_by, min_as_of, inventory_anchors, after_mutation_ref, wait_ms, and the complete/coverage response fields are unexplained, leaving most of the surface ambiguous.

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

Purpose3/5

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

The description opens with 'Read one scope or a server-side batch,' giving a verb (read) and a scope (single vs. batch), which is a reasonable summary of reading insights. However, it does not distinguish this tool from several sibling tools like insights_query_batch_overview, insights_query_overview, or insights_pull_insights, so an agent can't easily tell which query tool to pick.

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

Usage Guidelines3/5

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

It mentions when to supply group_by/dates/scope via request OR direct fields for query_contract_version=1, and tells the agent to poll task_ref rather than re-issuing refreshes, which is real 'how' guidance. But it never names alternatives or states when to choose this tool over the other insights_* query tools.

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?