SEOmatic

Previous value: -"Which operation to run. list (campaigns with status + task counts); manage (approve/pause/resume/abandon/update a campaign); propose_page_scale (a set of pages on the site own page or own template); propose_location_pages (location pages on the site own layout (drafts), or existing ones improved); propose_content_sweep (N distinct blog articles as a campaign); propose_bulk_edit (one instruction across many pages); write_articles (direct N-article staging)."New value: +"Which operation to run. list (campaigns with status + task counts); manage (approve/pause/resume/abandon/update a campaign); expand (release a bulk sweep's held later waves: estimate only without confirm: true); undo (undo every live change the campaign applied (confirm: true after the user's explicit ask)); propose_page_scale (a set of pages on the site own page or own template); propose_location_pages (location pages on the site own layout (drafts), or existing ones improved); propose_content_sweep (N distinct blog articles as a campaign); propose_bulk_edit (one instruction across many pages); write_articles (direct N-article staging)."

Previous value: -[
-  "list",
-  "manage",
-  "propose_page_scale",
-  "propose_location_pages",
-  "propose_content_sweep",
-  "propose_bulk_edit",
-  "write_articles"
-]New value: +[
+  "list",
+  "manage",
+  "expand",
+  "undo",
+  "propose_page_scale",
+  "propose_location_pages",
+  "propose_content_sweep",
+  "propose_bulk_edit",
+  "write_articles"
+]

Previous value: -"manage only: the campaign to act on."New value: +"manage/expand/undo: the campaign to act on."

Previous value: -"manage only, approve + abandon: must be true - attests the user explicitly asked for this (approve releases work + spend; abandon is irreversible)."New value: +"manage (approve, abandon), expand, undo, and save_article with publish: true: must be true, attesting the user explicitly asked for this (approve releases work and spend; abandon is irreversible; publish sends the article to the CMS). Without it expand returns the estimate only."

Added value: +{
+  "description": "save_article with publish: the same attestation as confirm, the spelling the confirm widget sends.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "undo only: also restore pages a person edited since. Set ONLY after the user saw the skipped list and chose to overwrite those edits.",
+  "type": "boolean"
+}

Previous value: -"propose_page_scale only: publish pages as drafts."New value: +"save_article with publish: default true (a draft in the CMS); false = live. In approval mode the article is always a draft. Also propose_page_scale: publish pages as drafts."

Previous value: -"Which operation to run. find_page_set_patterns (keyword research for a page set: the repeated query templates with a varying slot, entities ranked by demand (a seed term adds the keyword provider and costs credits)); list_datasets (available datasets); list_page_projects (the site own page projects (own {{Column}} templates)); dataset_rows (sample rows from one dataset); list_templates (built-in page templates); get_template (one template in full)."New value: +"Which operation to run. find_page_set_patterns (keyword research for a page set: the repeated query templates with a varying slot, entities ranked by demand (a seed term adds the keyword provider and costs credits)); list_datasets (available datasets); dataset_rows (sample rows from one dataset); list_templates (built-in page templates); get_template (one template in full)."

Previous value: -[
-  "find_page_set_patterns",
-  "list_datasets",
-  "list_page_projects",
-  "dataset_rows",
-  "list_templates",
-  "get_template"
-]New value: +[
+  "find_page_set_patterns",
+  "list_datasets",
+  "dataset_rows",
+  "list_templates",
+  "get_template"
+]

Previous value: -"Which operation to run. history (weekly position per query (target terms by default), up to 52 weeks); movers (biggest position gains and losses between two weeks); serp_history (who held the top 10 each week for one of the site's own queries, and competitor title changes)."New value: +"Which operation to run. history (weekly position per query (target terms by default), up to 52 weeks); movers (biggest position gains and losses between two weeks); serp_history (who held the top 10 each week for one of the site's own queries, and competitor title changes); add_keywords (add up to 100 keywords to a blog project (plan-capped per call; a refusal states the cap)); remove_keywords (remove keywords from a blog project by id, or all of them (confirm: true after the user's yes))."

Previous value: -[
-  "history",
-  "movers",
-  "serp_history"
-]New value: +[
+  "history",
+  "movers",
+  "serp_history",
+  "add_keywords",
+  "remove_keywords"
+]

Added value: +{
+  "description": "remove_keywords: true removes every keyword of the project.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "remove_keywords (required true): the user explicitly asked to remove exactly these keywords. Never set it on your own judgment.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "remove_keywords: the same attestation, as the confirm widget and the elicitation retry send it.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "remove_keywords: the keyword ids to remove (1 to 100). Pass this or all: true.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "add_keywords only (required): 1 to 100 keywords; a duplicate refuses the call.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "add_keywords: two-letter language code (default: the workspace market).",
+  "type": "string"
+}

Added value: +{
+  "description": "add_keywords: locale location code (default: the workspace market).",
+  "type": "integer"
+}

Added value: +{
+  "description": "add_keywords/remove_keywords (required): the blog project id (dataset_library list_page_projects lists projects with their type; posts = blog).",
+  "type": "string"
+}

Previous value: -"Which operation to run. snapshot (compact brief of cached signals); strategy (themes + ranked big plays); signal (one cached signal in full); content_scores (AI-search scores for generated articles)."New value: +"Which operation to run. snapshot (compact brief of cached signals); strategy (themes + ranked big plays); signal (one cached signal in full); content_scores (AI-search scores for generated articles); client_report (the monthly client report: summary, search detail or work history); proof_links (the proof certificate links (search or AI); admin or owner)."

Previous value: -[
-  "snapshot",
-  "strategy",
-  "signal",
-  "content_scores"
-]New value: +[
+  "snapshot",
+  "strategy",
+  "signal",
+  "content_scores",
+  "client_report",
+  "proof_links"
+]

Added value: +{
+  "description": "proof_links only: which certificate (default search).",
+  "enum": [
+    "search",
+    "ai"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "client_report only: YYYY-MM (default the latest month).",
+  "type": "string"
+}

Added value: +{
+  "description": "client_report only: summary (default), search detail, or work history.",
+  "enum": [
+    "summary",
+    "search",
+    "work"
+  ],
+  "type": "string"
+}

Previous value: -"Which operation to run. list (the plan board (filterable)); get (one task in full detail); create (stage up to 5 task proposals); decide (approve or dismiss a staged proposal (the approval loop)); execute (run an approved task now; a reviewToken releases staged holds; refresh_pull_request updates an open GitHub pull request, or opens a new one if someone else changed its branch); rollback (undo an executed task's live change (drift-guarded)); paste_done (the user pasted a handed-over change; SEOmatic looks for it on the live page before measuring)."New value: +"Which operation to run. list (the plan board (filterable)); get (one task in full detail); create (stage up to 5 task proposals); decide (approve or dismiss a staged proposal (the approval loop)); execute (run an approved task now; a reviewToken releases staged holds; refresh_pull_request updates an open GitHub pull request, or opens a new one if someone else changed its branch); rollback (undo an executed task's live change (drift-guarded)); paste_done (the user pasted a handed-over change; SEOmatic looks for it on the live page before measuring); decide_batch (approve or dismiss up to 50 staged tasks in one call, same rails as decide; skipped ids come back with a reason); undo_all (undo EVERYTHING the agent has live, a few per call (confirm: true after the user's explicit ask; admin only)); done (the user made the change themselves; the task moves into measurement); to_campaign (hand a proposed content sweep to the Agent campaigns (the direct task is dismissed)); dismiss_reason (record why the user dismissed a task (closed set)); apply_site_change (apply a staged redirect, robots.txt or prune change the user saw (get's siteChange.shownHash, confirm: true; admin only)); resolve_site_change (resolve an earlier site change whose undo was never confirmed: undo it, or record the admin's 'I resolved it'); protected_pages (the money pages the agent never writes unattended); protect_pages (add, remove or replace the protected pages (admin or owner; removing a URL needs confirm: true))."

Previous value: -[
-  "list",
-  "get",
-  "create",
-  "decide",
-  "execute",
-  "rollback",
-  "paste_done"
-]New value: +[
+  "list",
+  "get",
+  "create",
+  "decide",
+  "execute",
+  "rollback",
+  "paste_done",
+  "decide_batch",
+  "undo_all",
+  "done",
+  "to_campaign",
+  "dismiss_reason",
+  "apply_site_change",
+  "resolve_site_change",
+  "protected_pages",
+  "protect_pages"
+]

Added value: +{
+  "description": "undo_all and apply_site_change: must be true, attesting the user explicitly asked for this exact action in this conversation. Never set it on your own judgment.",
+  "type": "boolean"
+}

Previous value: -"decide/execute: required true for indexation-destructive types (noindex, redirect). Attestation that the human explicitly signed off on this specific task after seeing its URL and consequence - never set it on your own judgment."New value: +"decide/decide_batch/execute: required true for indexation-destructive types (noindex, redirect); on decide_batch one attestation covers the call and the refusal names the ids. Attestation that the human explicitly signed off on those specific tasks after seeing their URLs and consequences - never set it on your own judgment."

Previous value: -"decide only: approve releases the task to the gated pipeline; dismiss archives it. Approving an indexation-destructive type (noindex, redirect) also requires confirmDestructive: true."New value: +"decide/decide_batch: approve releases the task(s) to the gated pipeline; dismiss archives. Approving an indexation-destructive type (noindex, redirect) also requires confirmDestructive: true."

Previous value: -"rollback only: undo even though the live page drifted from what the agent wrote. Set ONLY after the user explicitly confirmed overwriting their newer edit."New value: +"rollback/undo_all: undo even though the live page drifted from what the agent wrote (undo_all lists the skipped pages first). Set ONLY after the user explicitly confirmed overwriting their newer edit."

Added value: +{
+  "description": "resolve_site_change only (required): undo removes the change if still ours; confirm_resolved records the admin's own resolution.",
+  "enum": [
+    "undo",
+    "confirm_resolved"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "protect_pages only: full URLs on the site or /path/* prefixes, each with an optional reason (max 200).",
+  "items": {
+    "properties": {
+      "reason": {
+        "type": "string"
+      },
+      "url": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "url"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "protect_pages only: add (default), remove, or replace the whole list.",
+  "enum": [
+    "add",
+    "remove",
+    "replace"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "dismiss_reason only (required): why the user dismissed it.",
+  "enum": [
+    "wrong_page",
+    "not_priority",
+    "avoid_topic",
+    "felt_risky"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "apply_site_change only (required): siteChange.shownHash from get, the hash of the change the user saw; a mismatch is refused.",
+  "type": "string"
+}

Added value: +{
+  "description": "done only: what the user applied (e.g. the new title), kept for the verification report.",
+  "type": "string"
+}

Previous value: -"get/decide/execute/rollback/paste_done: the task to act on."New value: +"Every single-task action: the task to act on."

Added value: +{
+  "description": "decide_batch only (required): up to 50 task ids; more come back skipped over_limit.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Previous value: -"Which operation to run. summary (totals, referring domains, rank/spam); anchors (anchor-text distribution); velocity (monthly new vs lost referring domains); referring_domains (top linking domains); link_prospects (link intersect: linking to competitors but not to us)."New value: +"Which operation to run. summary (totals, referring domains, rank/spam); anchors (anchor-text distribution); velocity (monthly new vs lost referring domains); referring_domains (top linking domains); new_lost_links (the individual links gained or lost since a date); link_prospects (link intersect: linking to competitors but not to us)."

Previous value: -[
-  "summary",
-  "anchors",
-  "velocity",
-  "referring_domains",
-  "link_prospects"
-]New value: +[
+  "summary",
+  "anchors",
+  "velocity",
+  "referring_domains",
+  "new_lost_links",
+  "link_prospects"
+]

Previous value: -"anchors (default 25) and referring_domains (default 50)."New value: +"anchors (default 25), referring_domains (default 50), new_lost_links (1-500, default 100)."

Added value: +{
+  "description": "new_lost_links only: true = one link per referring domain.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "new_lost_links only: YYYY-MM-DD, default 30 days ago.",
+  "type": "string"
+}

Added value: +{
+  "description": "new_lost_links only: new (default) or lost links.",
+  "enum": [
+    "new",
+    "lost"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "'search_console_ai_pages' for the Pages export of Search Console's generative AI performance report",
+  "enum": [
+    "search_console_ai_pages"
+  ],
+  "type": "string"
+}

Added value: +{
+  "additionalProperties": false,
+  "description": "Required with search_console_ai_pages: the date range the user exported, as shown in Search Console. Never guess it.",
+  "properties": {
+    "end": {
+      "description": "YYYY-MM-DD",
+      "type": "string"
+    },
+    "start": {
+      "description": "YYYY-MM-DD",
+      "type": "string"
+    }
+  },
+  "required": [
+    "start",
+    "end"
+  ],
+  "type": "object"
+}

Previous value: -"Which operation to run. features (which SERP features appear for a keyword); domain_rankings (top keywords a domain ranks for); domain_overview (organic visibility distribution); domain_competitors (domains ranking for similar keywords)."New value: +"Which operation to run. features (which SERP features appear for a keyword); domain_rankings (top keywords a domain ranks for); domain_overview (organic visibility distribution); domain_competitors (domains ranking for similar keywords); top_pages (a domain's top pages by estimated organic traffic)."

Previous value: -[
-  "features",
-  "domain_rankings",
-  "domain_overview",
-  "domain_competitors"
-]New value: +[
+  "features",
+  "domain_rankings",
+  "domain_overview",
+  "domain_competitors",
+  "top_pages"
+]

Previous value: -"domain_rankings/domain_overview/domain_competitors: the domain. Omit for the connected workspace's own site (the server fills it in); pass only for a competitor."New value: +"domain_rankings/domain_overview/domain_competitors/top_pages: the domain. Omit for the connected workspace's own site (the server fills it in); pass only for a competitor."

Previous value: -"max results where applicable."New value: +"max results where applicable (top_pages 1-500, default 50)."

Previous value: -"Which operation to run. score_draft (score a pasted DRAFT pre-publish (deterministic, free)); analyze (SEO score + critical issues); crawl (title/meta/headings/links); inventory (the user's real synced pages)."New value: +"Which operation to run. score_draft (score a pasted DRAFT pre-publish (deterministic, free)); analyze (SEO score + critical issues); crawl (title/meta/headings/links); inventory (the user's real synced pages); pagespeed (Google PageSpeed now: lab metrics (score, LCP, CLS, TBT) and real-user field data (LCP, INP, CLS)); validate_schema (structured data vs Google rich-result rules: parse errors, missing required/recommended, wrong types (URL or pasted JSON-LD))."

Previous value: -[
-  "score_draft",
-  "analyze",
-  "crawl",
-  "inventory"
-]New value: +[
+  "score_draft",
+  "analyze",
+  "crawl",
+  "inventory",
+  "pagespeed",
+  "validate_schema"
+]

Added value: +{
+  "description": "validate_schema only: raw JSON-LD (a JSON document or <script type=\"application/ld+json\"> blocks) to validate instead of a URL.",
+  "type": "string"
+}

Added value: +{
+  "description": "pagespeed only: mobile (default) or desktop.",
+  "enum": [
+    "mobile",
+    "desktop"
+  ],
+  "type": "string"
+}

Previous value: -"analyze/crawl: the URL to inspect."New value: +"analyze/crawl/pagespeed: the URL to inspect. validate_schema: the page to fetch (or pass jsonld instead)."

Previous value: -"max rows where applicable."New value: +"max rows where applicable (ga4_report up to 10,000)."

Removed value: -{
-  "description": "Optional: one short sentence describing what the user is ultimately trying to achieve with this request. Used by SEOmatic to tailor answers and improve the product; never required.",
-  "maxLength": 300,
-  "type": "string"
-}

Removed value: -{
-  "description": "Optional: one short sentence describing what the user is ultimately trying to achieve with this request. Used by SEOmatic to tailor answers and improve the product; never required.",
-  "maxLength": 300,
-  "type": "string"
-}

Removed value: -{
-  "description": "Optional: one short sentence describing what the user is ultimately trying to achieve with this request. Used by SEOmatic to tailor answers and improve the product; never required.",
-  "maxLength": 300,
-  "type": "string"
-}

Removed value: -{
-  "description": "Optional: one short sentence describing what the user is ultimately trying to achieve with this request. Used by SEOmatic to tailor answers and improve the product; never required.",
-  "maxLength": 300,
-  "type": "string"
-}

Removed value: -{
-  "description": "Optional: one short sentence describing what the user is ultimately trying to achieve with this request. Used by SEOmatic to tailor answers and improve the product; never required.",
-  "maxLength": 300,
-  "type": "string"
-}

Removed value: -{
-  "description": "Optional: one short sentence describing what the user is ultimately trying to achieve with this request. Used by SEOmatic to tailor answers and improve the product; never required.",
-  "maxLength": 300,
-  "type": "string"
-}

Removed value: -{
-  "description": "Optional: one short sentence describing what the user is ultimately trying to achieve with this request. Used by SEOmatic to tailor answers and improve the product; never required.",
-  "maxLength": 300,
-  "type": "string"
-}

Removed value: -{
-  "description": "One sentence on the user's goal for this article (optional).",
-  "maxLength": 300,
-  "type": "string"
-}

Removed value: -{
-  "description": "Optional: one short sentence describing what the user is ultimately trying to achieve with this request. Used by SEOmatic to tailor answers and improve the product; never required.",
-  "maxLength": 300,
-  "type": "string"
-}

Removed value: -{
-  "description": "Optional: one short sentence describing what the user is ultimately trying to achieve with this request. Used by SEOmatic to tailor answers and improve the product; never required.",
-  "maxLength": 300,
-  "type": "string"
-}

Removed value: -{
-  "description": "Optional: one short sentence describing what the user is ultimately trying to achieve with this request. Used by SEOmatic to tailor answers and improve the product; never required.",
-  "maxLength": 300,
-  "type": "string"
-}

Removed value: -{
-  "description": "Optional: one short sentence describing what the user is ultimately trying to achieve with this request. Used by SEOmatic to tailor answers and improve the product; never required.",
-  "maxLength": 300,
-  "type": "string"
-}

Removed value: -{
-  "description": "Optional: one short sentence describing what the user is ultimately trying to achieve with this request. Used by SEOmatic to tailor answers and improve the product; never required.",
-  "maxLength": 300,
-  "type": "string"
-}

Removed value: -{
-  "description": "Optional: one short sentence describing what the user is ultimately trying to achieve with this request. Used by SEOmatic to tailor answers and improve the product; never required.",
-  "maxLength": 300,
-  "type": "string"
-}

Removed value: -{
-  "description": "Optional: one short sentence describing what the user is ultimately trying to achieve with this request. Used by SEOmatic to tailor answers and improve the product; never required.",
-  "maxLength": 300,
-  "type": "string"
-}

Removed value: -{
-  "description": "Optional: one short sentence describing what the user is ultimately trying to achieve with this request. Used by SEOmatic to tailor answers and improve the product; never required.",
-  "maxLength": 300,
-  "type": "string"
-}

Removed value: -{
-  "description": "Optional: one short sentence describing what the user is ultimately trying to achieve with this request. Used by SEOmatic to tailor answers and improve the product; never required.",
-  "maxLength": 300,
-  "type": "string"
-}

Removed value: -{
-  "description": "Optional: one short sentence describing what the user is ultimately trying to achieve with this request. Used by SEOmatic to tailor answers and improve the product; never required.",
-  "maxLength": 300,
-  "type": "string"
-}

Removed value: -{
-  "description": "Optional: one short sentence describing what the user is ultimately trying to achieve with this request. Used by SEOmatic to tailor answers and improve the product; never required.",
-  "maxLength": 300,
-  "type": "string"
-}

Removed value: -{
-  "description": "Optional: one short sentence describing what the user is ultimately trying to achieve with this request. Used by SEOmatic to tailor answers and improve the product; never required.",
-  "maxLength": 300,
-  "type": "string"
-}

Previous value: -"query_page_matrix only: max query-page pairs (default 2000)."New value: +"query_page_matrix only: max query-page pairs (100-1000, default 200)."

Removed value: -{
-  "description": "Optional: one short sentence describing what the user is ultimately trying to achieve with this request. Used by SEOmatic to tailor answers and improve the product; never required.",
-  "maxLength": 300,
-  "type": "string"
-}

Removed value: -{
-  "description": "Optional: one short sentence describing what the user is ultimately trying to achieve with this request. Used by SEOmatic to tailor answers and improve the product; never required.",
-  "maxLength": 300,
-  "type": "string"
-}

Removed value: -{
-  "description": "Optional: one short sentence describing what the user is ultimately trying to achieve with this request. Used by SEOmatic to tailor answers and improve the product; never required.",
-  "maxLength": 300,
-  "type": "string"
-}

Removed value: -{
-  "description": "Optional: one short sentence describing what the user is ultimately trying to achieve with this request. Used by SEOmatic to tailor answers and improve the product; never required.",
-  "maxLength": 300,
-  "type": "string"
-}

Removed value: -{
-  "description": "Optional: one short sentence describing what the user is ultimately trying to achieve with this request. Used by SEOmatic to tailor answers and improve the product; never required.",
-  "maxLength": 300,
-  "type": "string"
-}

Removed value: -{
-  "description": "Optional: one short sentence describing what the user is ultimately trying to achieve with this request. Used by SEOmatic to tailor answers and improve the product; never required.",
-  "maxLength": 300,
-  "type": "string"
-}

Removed value: -{
-  "description": "Optional: one short sentence describing what the user is ultimately trying to achieve with this request. Used by SEOmatic to tailor answers and improve the product; never required.",
-  "maxLength": 300,
-  "type": "string"
-}

Removed value: -{
-  "description": "Optional: one short sentence describing what the user is ultimately trying to achieve with this request. Used by SEOmatic to tailor answers and improve the product; never required.",
-  "maxLength": 300,
-  "type": "string"
-}

Removed value: -{
-  "description": "Optional: one short sentence describing what the user is ultimately trying to achieve with this request. Used by SEOmatic to tailor answers and improve the product; never required.",
-  "maxLength": 300,
-  "type": "string"
-}

Removed value: -{
-  "description": "Optional: one short sentence describing what the user is ultimately trying to achieve with this request. Used by SEOmatic to tailor answers and improve the product; never required.",
-  "maxLength": 300,
-  "type": "string"
-}

Removed value: -{
-  "description": "Optional: one short sentence describing what the user is ultimately trying to achieve with this request. Used by SEOmatic to tailor answers and improve the product; never required.",
-  "maxLength": 300,
-  "type": "string"
-}

Removed value: -{
-  "description": "Optional: one short sentence describing what the user is ultimately trying to achieve with this request. Used by SEOmatic to tailor answers and improve the product; never required.",
-  "maxLength": 300,
-  "type": "string"
-}

Removed value: -{
-  "description": "Optional: one short sentence describing what the user is ultimately trying to achieve with this request. Used by SEOmatic to tailor answers and improve the product; never required.",
-  "maxLength": 300,
-  "type": "string"
-}

Removed value: -{
-  "description": "Optional: one short sentence describing what the user is ultimately trying to achieve with this request. Used by SEOmatic to tailor answers and improve the product; never required.",
-  "maxLength": 300,
-  "type": "string"
-}

Removed value: -{
-  "description": "Optional: one short sentence describing what the user is ultimately trying to achieve with this request. Used by SEOmatic to tailor answers and improve the product; never required.",
-  "maxLength": 300,
-  "type": "string"
-}

Removed value: -{
-  "description": "Optional: one short sentence describing what the user is ultimately trying to achieve with this request. Used by SEOmatic to tailor answers and improve the product; never required.",
-  "maxLength": 300,
-  "type": "string"
-}

Removed value: -{
-  "description": "Optional: one short sentence describing what the user is ultimately trying to achieve with this request. Used by SEOmatic to tailor answers and improve the product; never required.",
-  "maxLength": 300,
-  "type": "string"
-}

Removed value: -{
-  "description": "Optional: one short sentence describing what the user is ultimately trying to achieve with this request. Used by SEOmatic to tailor answers and improve the product; never required.",
-  "maxLength": 300,
-  "type": "string"
-}

Previous value: -"Which operation to run. list_datasets (available datasets); list_page_projects (the site own page projects (own {{Column}} templates)); dataset_rows (sample rows from one dataset); list_templates (built-in page templates); get_template (one template in full)."New value: +"Which operation to run. find_page_set_patterns (keyword research for a page set: the repeated query templates with a varying slot, entities ranked by demand (a seed term adds the keyword provider and costs credits)); list_datasets (available datasets); list_page_projects (the site own page projects (own {{Column}} templates)); dataset_rows (sample rows from one dataset); list_templates (built-in page templates); get_template (one template in full)."

Previous value: -[
-  "list_datasets",
-  "list_page_projects",
-  "dataset_rows",
-  "list_templates",
-  "get_template"
-]New value: +[
+  "find_page_set_patterns",
+  "list_datasets",
+  "list_page_projects",
+  "dataset_rows",
+  "list_templates",
+  "get_template"
+]

Added value: +{
+  "description": "find_page_set_patterns: smallest set worth showing (default 5).",
+  "type": "integer"
+}

Added value: +{
+  "description": "find_page_set_patterns: a head term to research with the keyword provider ('signage'); omit for Search Console only.",
+  "type": "string"
+}

Previous value: -"write_articles only: default false (stage as drafts)."New value: +"write_articles only: default true (articles that pass our checks publish on their own, with undo); false keeps them as drafts."

Previous value: -"Which operation to run. list (campaigns with status + task counts); manage (approve/pause/resume/abandon/update a campaign); propose_page_scale (programmatic landing pages at scale); propose_location_pages (location pages on the site own layout (drafts), or existing ones improved); propose_content_sweep (N distinct blog articles as a campaign); propose_bulk_edit (one instruction across many pages); write_articles (direct N-article staging)."New value: +"Which operation to run. list (campaigns with status + task counts); manage (approve/pause/resume/abandon/update a campaign); propose_page_scale (a set of pages on the site own page or own template); propose_location_pages (location pages on the site own layout (drafts), or existing ones improved); propose_content_sweep (N distinct blog articles as a campaign); propose_bulk_edit (one instruction across many pages); write_articles (direct N-article staging)."

Previous value: -"propose_location_pages, create: the customer's page the new pages copy (layout, embeds, page type)."New value: +"propose_location_pages (create) and propose_page_scale: the customer's own page the new pages copy (layout, embeds, page type). propose_page_scale needs exemplarUrl or projectId."

Removed value: -{
-  "description": "propose_page_scale only: built-in template id.",
-  "type": "string"
-}

Added value: +{
+  "description": "propose_page_scale: the customer's own project whose fields hold their {{Column}} template. Needs projectId or exemplarUrl.",
+  "type": "string"
+}

Removed value: -{
-  "description": "propose_page_scale, rowSourceKind=ai: dataset to generate.",
-  "type": "string"
-}

Previous value: -"propose_page_scale only (required): where page rows come from."New value: +"propose_page_scale only: where page rows come from (required with exemplarUrl; with projectId defaults to the project dataset). No AI source: an invented row list is refused."

Previous value: -[
-  "ai",
-  "user",
-  "library",
-  "gbp_locations"
-]New value: +[
+  "user",
+  "library",
+  "gbp_locations"
+]

Previous value: -"Which operation to run. list_datasets (available datasets); dataset_rows (sample rows from one dataset); list_templates (built-in page templates); get_template (one template in full)."New value: +"Which operation to run. list_datasets (available datasets); list_page_projects (the site own page projects (own {{Column}} templates)); dataset_rows (sample rows from one dataset); list_templates (built-in page templates); get_template (one template in full)."

Previous value: -[
-  "list_datasets",
-  "dataset_rows",
-  "list_templates",
-  "get_template"
-]New value: +[
+  "list_datasets",
+  "list_page_projects",
+  "dataset_rows",
+  "list_templates",
+  "get_template"
+]

Previous value: -"Which operation to run. list (campaigns with status + task counts); manage (approve/pause/resume/abandon/update a campaign); propose_page_scale (programmatic landing pages at scale); propose_content_sweep (N distinct blog articles as a campaign); propose_bulk_edit (one instruction across many pages); write_articles (direct N-article staging)."New value: +"Which operation to run. list (campaigns with status + task counts); manage (approve/pause/resume/abandon/update a campaign); propose_page_scale (programmatic landing pages at scale); propose_location_pages (location pages on the site own layout (drafts), or existing ones improved); propose_content_sweep (N distinct blog articles as a campaign); propose_bulk_edit (one instruction across many pages); write_articles (direct N-article staging)."

Previous value: -[
-  "list",
-  "manage",
-  "propose_page_scale",
-  "propose_content_sweep",
-  "propose_bulk_edit",
-  "write_articles"
-]New value: +[
+  "list",
+  "manage",
+  "propose_page_scale",
+  "propose_location_pages",
+  "propose_content_sweep",
+  "propose_bulk_edit",
+  "write_articles"
+]

Added value: +{
+  "description": "propose_location_pages, create: the place the model page is about, when its title does not say.",
+  "type": "string"
+}

Added value: +{
+  "description": "propose_location_pages, create: the customer's page the new pages copy (layout, embeds, page type).",
+  "type": "string"
+}

Added value: +{
+  "description": "propose_location_pages only (required): create = new draft pages modelled on exemplarUrl; enrich = rewrite existing location pages (rows carry pageUrl).",
+  "enum": [
+    "create",
+    "enrich"
+  ],
+  "type": "string"
+}

Previous value: -"propose_page_scale, rowSourceKind=user: one object per page."New value: +"propose_page_scale, rowSourceKind=user: one object per page. propose_location_pages (required): one object per location (name + the facts the user gave; enrich: pageUrl)."

Previous value: -"propose_page_scale (required), propose_content_sweep (required), propose_bulk_edit (optional)."New value: +"propose_page_scale (required), propose_content_sweep (required), propose_bulk_edit and propose_location_pages (optional)."

Previous value: -"Which operation to run. list (the plan board (filterable)); get (one task in full detail); create (stage up to 5 task proposals); decide (approve or dismiss a staged proposal (the approval loop)); execute (run an approved task now; a reviewToken releases staged holds; refresh_pull_request updates an open GitHub pull request, or opens a new one if someone else changed its branch); rollback (undo an executed task's live change (drift-guarded))."New value: +"Which operation to run. list (the plan board (filterable)); get (one task in full detail); create (stage up to 5 task proposals); decide (approve or dismiss a staged proposal (the approval loop)); execute (run an approved task now; a reviewToken releases staged holds; refresh_pull_request updates an open GitHub pull request, or opens a new one if someone else changed its branch); rollback (undo an executed task's live change (drift-guarded)); paste_done (the user pasted a handed-over change; SEOmatic looks for it on the live page before measuring)."

Previous value: -[
-  "list",
-  "get",
-  "create",
-  "decide",
-  "execute",
-  "rollback"
-]New value: +[
+  "list",
+  "get",
+  "create",
+  "decide",
+  "execute",
+  "rollback",
+  "paste_done"
+]

Previous value: -"get/decide/execute/rollback: the task to act on."New value: +"get/decide/execute/rollback/paste_done: the task to act on."

Previous value: -"Which operation to run. top_queries (top search queries); top_pages (top pages); dimension_breakdown (by device/country/date); query_page_matrix (cannibalization / query-to-page map); query_pages (which pages rank for given queries, with each page's own numbers); compare_periods (decay/growth vs the prior period); trend (daily clicks/impressions over time); discover_news (Discover / News / Image / Video surfaces); folder_rollup (performance by URL folder / site section); fresh (provisional today/yesterday numbers (hours-old data))."New value: +"Which operation to run. top_queries (top search queries); top_pages (top pages); dimension_breakdown (by device/country/date, or one page's queries (query + filterPage) / one query's pages (page + filterQuery)); query_page_matrix (cannibalization / query-to-page map); query_pages (which pages rank for given queries, with each page's own numbers); compare_periods (decay/growth vs the prior period); trend (daily clicks/impressions over time); discover_news (Discover / News / Image / Video surfaces); folder_rollup (performance by URL folder / site section); fresh (provisional today/yesterday numbers (hours-old data))."

Previous value: -"REQUIRED for dimension_breakdown (device|country|date). For compare_periods: query|page (default page). Ignored otherwise."New value: +"REQUIRED for dimension_breakdown: device|country|date|query|page (query + filterPage = the queries one page ranks for, with that page's own numbers; page + filterQuery = the pages ranking for one query). For compare_periods: query|page (default page). Ignored otherwise."

Previous value: -"dimension_breakdown only: restrict to one exact page URL."New value: +"dimension_breakdown only: restrict to one exact page URL, as Search Console records it (pair with dimension=query to see the queries that page ranks for)."

Previous value: -"dimension_breakdown only: restrict to one exact query."New value: +"dimension_breakdown only: restrict to one exact query (pair with dimension=page to see which pages rank for it)."

Added value: +{
+  "description": "Set true only after the user confirmed that `site` is their own website; the workspace then remembers it.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "What the business sells or does, in the words a customer would search (e.g. \"wedding photographer lyon\"). Use when no site is on record and the user has not given one: the answer sizes that market instead.",
+  "maxLength": 80,
+  "type": "string"
+}

Previous value: -"Which operation to run. top_queries (top search queries); top_pages (top pages); dimension_breakdown (by device/country/date); query_page_matrix (cannibalization / query-to-page map); compare_periods (decay/growth vs the prior period); trend (daily clicks/impressions over time); discover_news (Discover / News / Image / Video surfaces); folder_rollup (performance by URL folder / site section); fresh (provisional today/yesterday numbers (hours-old data))."New value: +"Which operation to run. top_queries (top search queries); top_pages (top pages); dimension_breakdown (by device/country/date); query_page_matrix (cannibalization / query-to-page map); query_pages (which pages rank for given queries, with each page's own numbers); compare_periods (decay/growth vs the prior period); trend (daily clicks/impressions over time); discover_news (Discover / News / Image / Video surfaces); folder_rollup (performance by URL folder / site section); fresh (provisional today/yesterday numbers (hours-old data))."

Previous value: -[
-  "top_queries",
-  "top_pages",
-  "dimension_breakdown",
-  "query_page_matrix",
-  "compare_periods",
-  "trend",
-  "discover_news",
-  "folder_rollup",
-  "fresh"
-]New value: +[
+  "top_queries",
+  "top_pages",
+  "dimension_breakdown",
+  "query_page_matrix",
+  "query_pages",
+  "compare_periods",
+  "trend",
+  "discover_news",
+  "folder_rollup",
+  "fresh"
+]

Added value: +{
+  "description": "query_pages only: a full page URL to check - returns its own row for each query, or null when it does not rank.",
+  "type": "string"
+}

Added value: +{
+  "description": "REQUIRED for query_pages: 1-5 exact search queries. Page rows are that page's own numbers; queryTotal is site-wide and never a page's number.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Previous value: -"Which operation to run. list (the plan board (filterable)); get (one task in full detail); create (stage up to 5 task proposals); decide (approve or dismiss a staged proposal (the approval loop)); execute (run an approved task now; a reviewToken releases staged holds); rollback (undo an executed task's live change (drift-guarded))."New value: +"Which operation to run. list (the plan board (filterable)); get (one task in full detail); create (stage up to 5 task proposals); decide (approve or dismiss a staged proposal (the approval loop)); execute (run an approved task now; a reviewToken releases staged holds; refresh_pull_request updates an open GitHub pull request, or opens a new one if someone else changed its branch); rollback (undo an executed task's live change (drift-guarded))."

Added value: +{
+  "description": "execute only, GitHub: rewrite the task's OPEN pull request against the site's latest version (the dashboard's Refresh): updates the pull request, or opens a new one if someone else changed its branch. Runs the task again, so it uses AI credits like the first run - set it ONLY when the user asked for the refresh.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "Only when the workspace has no site on record yet: true if the domain is the user's own site, false if it is a competitor. Ask the user; never guess.",
+  "type": "boolean"
+}

Previous value: -"Which operation to run. list (tracked prompts + plan allowance + cadence); add (track a new buyer question (plan-capped)); update (rename / pin / (de)activate a prompt); remove (delete a prompt permanently (confirm with the user)); set_cadence (weekly / daily / manual - daily is ~7x spend, explicit user ask only)."New value: +"Which operation to run. list (tracked prompts + plan allowance + cadence); add (track a new buyer question (plan-capped)); update (rename / pin / (de)activate a prompt); remove (delete a prompt permanently (confirm with the user)); set_cadence (weekly / daily / manual - daily is ~7x spend, explicit user ask only); set_engines (choose tracked AI engines (full list) or reset to defaults - each engine adds scan cost, quote it first)."

Previous value: -[
-  "list",
-  "add",
-  "update",
-  "remove",
-  "set_cadence"
-]New value: +[
+  "list",
+  "add",
+  "update",
+  "remove",
+  "set_cadence",
+  "set_engines"
+]

Added value: +{
+  "description": "set_engines: the FULL list of engine ids to track (see list for ids and per-engine cost).",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "set_engines: true tracks the default engines.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "Competitor domain to scan instead of your own site, e.g. \"competitor.com\". Omit for your own site.",
+  "maxLength": 253,
+  "type": "string"
+}