publinker-cli 0.6.2__py3-none-any.whl

publinker_cli/routes.yaml

@@ -0,0 +1,1648 @@
+# publinker-cli route manifest — CUSTOMER build.
+#
+# Generated by scripts/build-customer-wheel.sh from the full manifest.
+# 92 customer routes; 38 internal routes removed.
+# Do not edit: rebuild from the repo manifest instead.
+
+- id: get_permissions
+  path: /permissions
+  method: GET
+  risk: read
+  audience: customer
+  cli:
+    group: []
+    command: permissions
+  mcp:
+    expose: true
+    tool_name: get_permissions
+    description: Return the current caller's permission set (sites, modules, admin flags).
+- id: fetch_permissions
+  path: /fetch-permissions
+  method: GET
+  risk: read
+  audience: customer
+  cli:
+    group: []
+    command: fetch-permissions
+  mcp:
+    expose: false
+    tool_name: null
+    description: ''
+- id: list_sites
+  path: /site
+  method: GET
+  risk: read
+  audience: customer
+  cli:
+    group:
+    - site
+    command: list
+  mcp:
+    expose: true
+    tool_name: list_sites
+    description: List every site the caller has permission to view.
+- id: list_companies
+  path: /company
+  method: GET
+  risk: read
+  audience: customer
+  cli:
+    group:
+    - company
+    command: list
+  mcp:
+    expose: true
+    tool_name: list_companies
+    description: List every company the caller has permission to view.
+- id: get_company
+  path: /company/{company_id}
+  method: GET
+  risk: read
+  audience: customer
+  cli:
+    group:
+    - company
+    command: get
+  mcp:
+    expose: true
+    tool_name: get_company
+    description: Fetch a single company by id.
+  args:
+  - name: company_id
+    help: The company id to fetch.
+- id: get_site_company
+  path: /site/{site}/company
+  method: GET
+  risk: read
+  audience: customer
+  cli:
+    group:
+    - site
+    - company
+    command: get
+  mcp:
+    expose: true
+    tool_name: get_site_company
+    description: Return the company that owns the given site.
+- id: get_site_dashboard
+  path: /site/{site}/dashboard
+  method: GET
+  risk: read
+  audience: customer
+  cli:
+    group:
+    - site
+    - dashboard
+    command: get
+  mcp:
+    expose: true
+    tool_name: get_site_dashboard
+    description: Return the dashboard summary for a site (KPIs, recent activity).
+- id: list_url_types
+  path: /site/{site}/url-type
+  method: GET
+  risk: read
+  audience: customer
+  cli:
+    group:
+    - site
+    - url-type
+    command: list
+  mcp:
+    expose: true
+    tool_name: list_url_types
+    description: List configured URL types (page categories) for a site.
+- id: list_dimension_groups
+  path: /site/{site}/dimension-group
+  method: GET
+  risk: read
+  audience: customer
+  cli:
+    group:
+    - site
+    - dimension-group
+    command: list
+  mcp:
+    expose: true
+    tool_name: list_dimension_groups
+    description: List dimension groups (custom aggregations) configured for a site.
+- id: get_pricing
+  path: /site/{site}/pricing
+  method: GET
+  risk: read
+  audience: customer
+  cli:
+    group:
+    - site
+    - pricing
+    command: get
+  mcp:
+    expose: true
+    tool_name: get_pricing
+    description: Get the deployed UPR floors pricing for a site.
+- id: get_pricing_old
+  path: /site/{site}/pricing-old
+  method: GET
+  risk: read
+  audience: customer
+  cli:
+    group:
+    - site
+    - pricing
+    command: get-old
+  mcp:
+    expose: false
+    tool_name: null
+    description: ''
+- id: get_pricing_import
+  path: /site/{site}/pricing-import
+  method: GET
+  risk: read
+  audience: customer
+  cli:
+    group:
+    - site
+    - pricing
+    command: import
+  mcp:
+    expose: false
+    tool_name: null
+    description: ''
+- id: get_pricing_staging
+  path: /site/{site}/pricing-staging
+  method: GET
+  risk: read
+  audience: customer
+  cli:
+    group:
+    - site
+    - pricing
+    command: get-staging
+  mcp:
+    expose: true
+    tool_name: get_pricing_staging
+    description: Get the staged (not yet deployed) UPR floors pricing for a site.
+- id: list_pricing_history
+  path: /site/{site}/pricing-history
+  method: GET
+  risk: read
+  audience: customer
+  cli:
+    group:
+    - site
+    - pricing-history
+    command: list
+  mcp:
+    expose: true
+    tool_name: list_pricing_history
+    description: List pricing change history entries for a site.
+- id: get_pricing_history_item
+  path: /site/{site}/pricing-history/{item_id}
+  method: GET
+  risk: read
+  audience: customer
+  cli:
+    group:
+    - site
+    - pricing-history
+    command: get
+  mcp:
+    expose: true
+    tool_name: get_pricing_history_item
+    description: Fetch one pricing history entry by id.
+  args:
+  - name: item_id
+    help: The pricing history entry id.
+- id: get_config
+  path: /site/{site}/config
+  method: GET
+  risk: read
+  audience: customer
+  cli:
+    group:
+    - site
+    - config
+    command: get
+  mcp:
+    expose: true
+    tool_name: get_config
+    description: Get the active wrapper config (JS settings) for a site.
+- id: list_config_history
+  path: /site/{site}/config-history
+  method: GET
+  risk: read
+  audience: customer
+  cli:
+    group:
+    - site
+    - config-history
+    command: list
+  mcp:
+    expose: true
+    tool_name: list_config_history
+    description: List config change history entries for a site.
+- id: get_config_history_item
+  path: /site/{site}/config-history/{item_id}
+  method: GET
+  risk: read
+  audience: customer
+  cli:
+    group:
+    - site
+    - config-history
+    command: get
+  mcp:
+    expose: true
+    tool_name: get_config_history_item
+    description: Fetch one config history entry by id.
+  args:
+  - name: item_id
+    help: The config history entry id.
+- id: list_wrapper_deploys
+  path: /site/{site}/wrapper-deploys
+  method: GET
+  risk: read
+  audience: customer
+  cli:
+    group:
+    - site
+    - wrapper-deploys
+    command: list
+  mcp:
+    expose: true
+    tool_name: list_wrapper_deploys
+    description: List recent wrapper (JS) deployments for a site.
+- id: get_report
+  path: /site/{site}/report
+  method: GET
+  risk: read
+  audience: customer
+  cli:
+    group:
+    - site
+    - report
+    command: get
+  mcp:
+    expose: true
+    tool_name: get_report
+    description: Get the main aggregated report for a site (filters via query params).
+  query_args:
+  - name: platform
+    help: "Required. Source platform \u2014 must match how the ETL bucketed the rows.\nKnown values: google_admanager\
+      \ | google_ads | active_campaign | google_postmaster | escalated.\nSee `publinker site report list-options`\
+      \ for examples.\n"
+  - name: account_id
+    help: Required. GAM network code, Ads customer id, or the platform-specific account identifier.
+  - name: dimensions_keys
+    help: "Required. Comma-separated dimensions; determines aggregation level.\nCommon values:\n  date\
+      \                                                   \u2014 daily aggregate\n  date,channel     \
+      \                                      \u2014 daily by channel\n  date,channel,adunit          \
+      \                          \u2014 + ad unit\n  date,channel,country_code,country_name,url,adunit\
+      \      \u2014 full per-URL detail\n  date,domain,device,country                             \u2014\
+      \ escalated reports\nThe set is platform-dependent; ask the ETL team if unsure.\n"
+  - name: date_start
+    help: Required. Start date YYYY-MM-DD.
+  - name: date_stop
+    help: Required. End date YYYY-MM-DD.
+- id: get_report_with_exchange
+  path: /site/{site}/report-with-exchange
+  method: GET
+  risk: read
+  audience: customer
+  cli:
+    group:
+    - site
+    - report
+    command: get-with-exchange
+  mcp:
+    expose: true
+    tool_name: get_report_with_exchange
+    description: Get the report normalized to a single currency via FX conversion.
+  query_args:
+  - name: platform
+    help: "Required. Source platform \u2014 must match how the ETL bucketed the rows.\nKnown values: google_admanager\
+      \ | google_ads | active_campaign | google_postmaster | escalated.\nSee `publinker site report list-options`\
+      \ for examples.\n"
+  - name: account_id
+    help: Required. GAM network code, Ads customer id, or the platform-specific account identifier.
+  - name: dimensions_keys
+    help: "Required. Comma-separated dimensions; determines aggregation level.\nCommon values:\n  date\
+      \                                                   \u2014 daily aggregate\n  date,channel     \
+      \                                      \u2014 daily by channel\n  date,channel,adunit          \
+      \                          \u2014 + ad unit\n  date,channel,country_code,country_name,url,adunit\
+      \      \u2014 full per-URL detail\n  date,domain,device,country                             \u2014\
+      \ escalated reports\nThe set is platform-dependent; ask the ETL team if unsure.\n"
+  - name: date_start
+    help: Required. Start date YYYY-MM-DD.
+  - name: date_stop
+    help: Required. End date YYYY-MM-DD.
+- id: get_ranking_email
+  path: /site/{site}/ranking-email
+  method: GET
+  risk: read
+  audience: customer
+  cli:
+    group:
+    - site
+    - report
+    command: ranking-email
+  mcp:
+    expose: false
+    tool_name: null
+    description: ''
+- id: list_quick_filters
+  path: /site/{site}/quick-filters
+  method: GET
+  risk: read
+  audience: customer
+  cli:
+    group:
+    - site
+    - quick-filters
+    command: list
+  mcp:
+    expose: true
+    tool_name: list_quick_filters
+    description: List saved quick filters for a site.
+- id: list_annotations
+  path: /site/{site}/annotations
+  method: GET
+  risk: read
+  audience: customer
+  cli:
+    group:
+    - site
+    - annotations
+    command: list
+  mcp:
+    expose: true
+    tool_name: list_annotations
+    description: List timeline annotations (notes pinned to dates) for a site.
+- id: get_postmaster
+  path: /site/{site}/postmaster
+  method: GET
+  risk: read
+  audience: customer
+  cli:
+    group:
+    - site
+    - postmaster
+    command: get
+  mcp:
+    expose: true
+    tool_name: get_postmaster
+    description: Get postmaster deliverability metrics for a site.
+- id: get_postmaster_config
+  path: /site/{site}/postmaster/config
+  method: GET
+  risk: read
+  audience: customer
+  cli:
+    group:
+    - site
+    - postmaster
+    - config
+    command: get
+  mcp:
+    expose: false
+    tool_name: null
+    description: ''
+- id: get_postmaster_oauth_status
+  path: /site/{site}/postmaster/oauth/status
+  method: GET
+  risk: read
+  audience: customer
+  cli:
+    group:
+    - site
+    - postmaster
+    - oauth
+    command: status
+  mcp:
+    expose: true
+    tool_name: get_postmaster_oauth_status
+    description: Report whether postmaster OAuth is connected for a site.
+- id: get_google_ads_oauth_status
+  path: /site/{site}/google-ads/oauth/status
+  method: GET
+  risk: read
+  audience: customer
+  cli:
+    group:
+    - site
+    - google-ads
+    - oauth
+    command: status
+  mcp:
+    expose: true
+    tool_name: get_google_ads_oauth_status
+    description: Report whether Google Ads OAuth is connected for a site.
+- id: get_google_analytics_oauth_status
+  path: /site/{site}/google-analytics/oauth/status
+  method: GET
+  risk: read
+  audience: customer
+  cli:
+    group:
+    - site
+    - google-analytics
+    - oauth
+    command: status
+  mcp:
+    expose: true
+    tool_name: get_google_analytics_oauth_status
+    description: Report whether Google Analytics OAuth is connected for a site.
+- id: list_gam_reports
+  path: /site/{site}/google-adm/gam-reports
+  method: GET
+  risk: read
+  audience: customer
+  cli:
+    group:
+    - site
+    - google-adm
+    - gam-reports
+    command: list
+  mcp:
+    expose: true
+    tool_name: list_gam_reports
+    description: List Google Ad Manager reports configured for a site.
+- id: get_gam_report_detail
+  path: /site/{site}/google-adm/gam-report-detail
+  method: GET
+  risk: read
+  audience: customer
+  cli:
+    group:
+    - site
+    - google-adm
+    - gam-reports
+    command: detail
+  mcp:
+    expose: true
+    tool_name: get_gam_report_detail
+    description: Get the detail rows for a specific Google Ad Manager report.
+- id: get_adspeed
+  path: /site/{site}/google-adm/adspeed
+  method: GET
+  risk: read
+  audience: customer
+  cli:
+    group:
+    - site
+    - google-adm
+    command: adspeed
+  mcp:
+    expose: true
+    tool_name: get_adspeed
+    description: Get ad-load speed metrics for a site (GAM).
+- id: list_quizzes
+  path: /site/{site}/quiz
+  method: GET
+  risk: read
+  audience: customer
+  cli:
+    group:
+    - site
+    - quiz
+    command: list
+  mcp:
+    expose: true
+    tool_name: list_quizzes
+    description: List LeadHub quizzes for a site.
+- id: get_quiz
+  path: /site/{site}/quiz/{quiz_id}
+  method: GET
+  risk: read
+  audience: customer
+  cli:
+    group:
+    - site
+    - quiz
+    command: get
+  mcp:
+    expose: true
+    tool_name: get_quiz
+    description: Fetch one LeadHub quiz by id.
+  args:
+  - name: quiz_id
+    help: The quiz id.
+- id: list_accounts
+  path: /site/{site}/account
+  method: GET
+  risk: read
+  audience: customer
+  cli:
+    group:
+    - site
+    - account
+    command: list
+  mcp:
+    expose: true
+    tool_name: list_accounts
+    description: List LeadHub accounts (ActiveCampaign / other ESPs) linked to a site.
+- id: list_account_lists
+  path: /site/{site}/account/{account_id}/lists
+  method: GET
+  risk: read
+  audience: customer
+  cli:
+    group:
+    - site
+    - account
+    - lists
+    command: list
+  mcp:
+    expose: true
+    tool_name: list_account_lists
+    description: List the mailing lists owned by one LeadHub account.
+  args:
+  - name: account_id
+    help: The LeadHub account id.
+- id: get_weight
+  path: /site/{site}/weight
+  method: GET
+  risk: read
+  audience: customer
+  cli:
+    group:
+    - site
+    - weight
+    command: get
+  mcp:
+    expose: true
+    tool_name: get_weight
+    description: Get LeadHub send-weight settings for a site.
+- id: get_email_checker
+  path: /site/{site}/email-checker
+  method: GET
+  risk: read
+  audience: customer
+  cli:
+    group:
+    - site
+    - email-checker
+    command: get
+  mcp:
+    expose: false
+    tool_name: null
+    description: ''
+- id: get_job_last_run
+  path: /site/{site}/job/{job_name}/last-run
+  method: GET
+  risk: read
+  audience: customer
+  cli:
+    group:
+    - site
+    - job
+    command: last-run
+  mcp:
+    expose: true
+    tool_name: get_job_last_run
+    description: Get the last-run record for a named background job on a site.
+  args:
+  - name: job_name
+    help: The job name (e.g., 'report-rollup').
+- id: get_facebook_ads_account
+  path: /site/{site}/facebook-ads/account
+  method: GET
+  risk: read
+  audience: customer
+  cli:
+    group:
+    - site
+    - facebook-ads
+    command: account
+  mcp:
+    expose: true
+    tool_name: get_facebook_ads_account
+    description: Get Facebook Ads account metadata for a site.
+- id: list_active_campaign_campaigns
+  path: /site/{site}/active-campaign/campaigns
+  method: GET
+  risk: read
+  audience: customer
+  cli:
+    group:
+    - site
+    - active-campaign
+    - campaigns
+    command: list
+  mcp:
+    expose: true
+    tool_name: list_active_campaign_campaigns
+    description: List ActiveCampaign campaigns for a site.
+- id: list_active_campaign_accounts
+  path: /site/{site}/active-campaign/accounts
+  method: GET
+  risk: read
+  audience: customer
+  cli:
+    group:
+    - site
+    - active-campaign
+    - accounts
+    command: list
+  mcp:
+    expose: true
+    tool_name: list_active_campaign_accounts
+    description: List ActiveCampaign accounts linked to a site.
+- id: get_currency
+  path: /currency
+  method: GET
+  risk: read
+  audience: customer
+  cli:
+    group: []
+    command: currency
+  mcp:
+    expose: true
+    tool_name: get_currency
+    description: Get the global currency table (FX rates).
+- id: create_url_type
+  path: /site/{site}/url-type
+  method: POST
+  risk: write
+  audience: customer
+  cli:
+    group:
+    - site
+    - url-type
+    command: create
+  mcp:
+    expose: false
+    tool_name: null
+    description: ''
+  body_args:
+  - name: url1
+    help: First URL pattern. Required.
+    required: true
+  - name: url2
+    help: Second URL pattern.
+  - name: url3
+    help: Third URL pattern.
+  - name: device
+    help: Device class (e.g. desktop, mobile).
+  - name: type
+    help: Type label for this group.
+- id: update_url_type
+  path: /site/{site}/url-type
+  method: PUT
+  risk: write
+  audience: customer
+  cli:
+    group:
+    - site
+    - url-type
+    command: update
+  mcp:
+    expose: false
+    tool_name: null
+    description: ''
+  body_args:
+  - name: id
+    help: Existing url-type id. Required.
+    required: true
+  - name: url1
+    help: First URL pattern.
+  - name: url2
+    help: Second URL pattern.
+  - name: url3
+    help: Third URL pattern.
+  - name: device
+    help: Device class.
+  - name: type
+    help: Type label.
+- id: delete_url_type
+  path: /site/{site}/url-type
+  method: DELETE
+  risk: write
+  audience: customer
+  cli:
+    group:
+    - site
+    - url-type
+    command: delete
+  mcp:
+    expose: false
+    tool_name: null
+    description: ''
+  body_args:
+  - name: id
+    help: url-type id to delete. Required.
+    required: true
+- id: create_annotation
+  path: /site/{site}/annotations
+  method: POST
+  risk: write
+  audience: customer
+  cli:
+    group:
+    - site
+    - annotations
+    command: create
+  mcp:
+    expose: false
+    tool_name: null
+    description: "Create an annotation tied to a specific URL \xD7 adunit on a site."
+  body_args:
+  - name: country_code
+    help: Two-letter country code (e.g. BR). Required.
+    required: true
+  - name: country_name
+    help: Human-readable country name. Required.
+    required: true
+  - name: channel
+    help: Traffic channel (e.g. organic, paid, email). Required.
+    required: true
+  - name: url
+    help: Absolute URL the annotation pins to. Required.
+    required: true
+  - name: adunit
+    help: Ad unit identifier (matches the GAM/report adunit value). Required.
+    required: true
+  - name: content
+    help: Annotation body text. Required.
+    required: true
+  - name: user_name
+    help: Display name of the author. Required.
+    required: true
+  - name: user_email
+    help: Email of the author. Required.
+    required: true
+- id: pricing_adjust
+  path: /site/{site}/pricing/adjust
+  method: POST
+  risk: write
+  audience: customer
+  body_args:
+  - name: body
+    help: 'Adjustment payload (JSON-encoded). Shape: {"dryRun": true, "adjustments": [{"match": {"country":
+      "BR", "device": "mobile"}, "op": "multiply", "value": 1.15}]}. Ops: set | multiply | increment |
+      percent | remove. An omitted match field means "any". Start with dryRun to see exactly which rules
+      change.'
+    required: true
+    json: true
+    raw: true
+  cli:
+    group:
+    - site
+    - pricing
+    command: adjust
+  mcp:
+    expose: false
+    description: 'Adjust floors by selector rather than by full payload. Not exposed to MCP: this reprices
+      live inventory and triggers a wrapper deploy.'
+- id: put_pricing
+  path: /site/{site}/pricing
+  method: PUT
+  risk: write
+  audience: customer
+  cli:
+    group:
+    - site
+    - pricing
+    command: put
+  mcp:
+    expose: false
+    tool_name: null
+    description: ''
+  body_args:
+  - name: body
+    help: Full pricing payload (JSON-encoded). Use --body '{...}' or pipe a file via shell substitution.
+      Required. Triggers a wrapper deploy via SQS.
+    required: true
+    json: true
+    raw: true
+- id: put_config
+  path: /site/{site}/config
+  method: PUT
+  risk: write
+  audience: customer
+  cli:
+    group:
+    - site
+    - config
+    command: put
+  mcp:
+    expose: false
+    tool_name: null
+    description: ''
+  body_args:
+  - name: body
+    help: Full config payload (JSON-encoded). Required. Triggers a wrapper deploy via SQS.
+    required: true
+    json: true
+    raw: true
+- id: site_dimension_group_create
+  path: /site/{site}/dimension-group
+  method: POST
+  risk: write
+  audience: customer
+  cli:
+    group:
+    - site
+    - dimension-group
+    command: create
+  mcp:
+    expose: false
+    tool_name: null
+    description: Create a dimension group for a site.
+  body_args:
+  - name: body
+    help: JSON request body. See app.py for the expected shape; field-level args can be added in a follow-up
+      PR.
+    json: true
+    raw: true
+- id: site_dimension_group_update
+  path: /site/{site}/dimension-group
+  method: PUT
+  risk: write
+  audience: customer
+  cli:
+    group:
+    - site
+    - dimension-group
+    command: update
+  mcp:
+    expose: false
+    tool_name: null
+    description: Update an existing dimension group.
+  body_args:
+  - name: body
+    help: JSON request body. See app.py for the expected shape; field-level args can be added in a follow-up
+      PR.
+    json: true
+    raw: true
+- id: site_dimension_group_delete
+  path: /site/{site}/dimension-group
+  method: DELETE
+  risk: write
+  audience: customer
+  cli:
+    group:
+    - site
+    - dimension-group
+    command: delete
+  mcp:
+    expose: false
+    tool_name: null
+    description: Delete a dimension group.
+  body_args:
+  - name: body
+    help: JSON request body. See app.py for the expected shape; field-level args can be added in a follow-up
+      PR.
+    json: true
+    raw: true
+- id: site_dimension_group_save_order
+  path: /site/{site}/dimension-group/order
+  method: POST
+  risk: write
+  audience: customer
+  cli:
+    group:
+    - site
+    - dimension-group
+    command: save-order
+  mcp:
+    expose: false
+    tool_name: null
+    description: Persist a new ordering for a site's dimension groups.
+  body_args:
+  - name: body
+    help: JSON request body. See app.py for the expected shape; field-level args can be added in a follow-up
+      PR.
+    json: true
+    raw: true
+- id: site_pricing_rollback_put
+  path: /site/{site}/pricing-rollback
+  method: PUT
+  risk: write
+  audience: customer
+  cli:
+    group:
+    - site
+    - pricing
+    command: rollback-put
+  mcp:
+    expose: false
+    tool_name: null
+    description: Roll back to a prior pricing snapshot (PUT variant).
+  body_args:
+  - name: body
+    help: JSON request body. See app.py for the expected shape; field-level args can be added in a follow-up
+      PR.
+    json: true
+    raw: true
+- id: site_pricing_rollback_post
+  path: /site/{site}/pricing-rollback
+  method: POST
+  risk: write
+  audience: customer
+  cli:
+    group:
+    - site
+    - pricing
+    command: rollback-post
+  mcp:
+    expose: false
+    tool_name: null
+    description: Roll back to a prior pricing snapshot (POST variant).
+  body_args:
+  - name: body
+    help: JSON request body. See app.py for the expected shape; field-level args can be added in a follow-up
+      PR.
+    json: true
+    raw: true
+- id: site_pricing_stage
+  path: /site/{site}/pricing-staging
+  method: PUT
+  risk: write
+  audience: customer
+  cli:
+    group:
+    - site
+    - pricing
+    command: stage
+  mcp:
+    expose: false
+    tool_name: null
+    description: Stage a pricing payload without deploying.
+  body_args:
+  - name: body
+    help: JSON request body. See app.py for the expected shape; field-level args can be added in a follow-up
+      PR.
+    json: true
+    raw: true
+- id: site_config_patch
+  path: /site/{site}/config/partial
+  method: PUT
+  risk: write
+  audience: customer
+  cli:
+    group:
+    - site
+    - config
+    command: patch
+  mcp:
+    expose: false
+    tool_name: null
+    description: Partial-update the site config without triggering a deploy.
+  body_args:
+  - name: body
+    help: JSON request body. See app.py for the expected shape; field-level args can be added in a follow-up
+      PR.
+    json: true
+    raw: true
+- id: site_facebook_ads_put_config
+  path: /site/{site}/facebook-ads/config
+  method: PUT
+  risk: write
+  audience: customer
+  cli:
+    group:
+    - site
+    - facebook-ads
+    command: put-config
+  mcp:
+    expose: false
+    tool_name: null
+    description: Update Facebook Ads integration config.
+  body_args:
+  - name: body
+    help: JSON request body. See app.py for the expected shape; field-level args can be added in a follow-up
+      PR.
+    json: true
+    raw: true
+- id: site_active_campaign_put_config
+  path: /site/{site}/active-campaign/config
+  method: PUT
+  risk: write
+  audience: customer
+  cli:
+    group:
+    - site
+    - active-campaign
+    command: put-config
+  mcp:
+    expose: false
+    tool_name: null
+    description: Update ActiveCampaign integration config.
+  body_args:
+  - name: body
+    help: JSON request body. See app.py for the expected shape; field-level args can be added in a follow-up
+      PR.
+    json: true
+    raw: true
+- id: site_quick_filters_create
+  path: /site/{site}/quick-filters
+  method: POST
+  risk: write
+  audience: customer
+  cli:
+    group:
+    - site
+    - quick-filters
+    command: create
+  mcp:
+    expose: false
+    tool_name: null
+    description: Create a quick-filter.
+  body_args:
+  - name: body
+    help: JSON request body. See app.py for the expected shape; field-level args can be added in a follow-up
+      PR.
+    json: true
+    raw: true
+- id: site_quick_filters_update
+  path: /site/{site}/quick-filters
+  method: PUT
+  risk: write
+  audience: customer
+  cli:
+    group:
+    - site
+    - quick-filters
+    command: update
+  mcp:
+    expose: false
+    tool_name: null
+    description: Update a quick-filter.
+  body_args:
+  - name: body
+    help: JSON request body. See app.py for the expected shape; field-level args can be added in a follow-up
+      PR.
+    json: true
+    raw: true
+- id: site_postmaster_add_domain
+  path: /site/{site}/postmaster/config
+  method: POST
+  risk: write
+  audience: customer
+  cli:
+    group:
+    - site
+    - postmaster
+    command: add-domain
+  mcp:
+    expose: false
+    tool_name: null
+    description: Add a Postmaster sender domain.
+  body_args:
+  - name: body
+    help: JSON request body. See app.py for the expected shape; field-level args can be added in a follow-up
+      PR.
+    json: true
+    raw: true
+- id: site_postmaster_select_domains
+  path: /site/{site}/postmaster/config
+  method: PUT
+  risk: write
+  audience: customer
+  cli:
+    group:
+    - site
+    - postmaster
+    command: select-domains
+  mcp:
+    expose: false
+    tool_name: null
+    description: Update Postmaster selected domains.
+  body_args:
+  - name: body
+    help: JSON request body. See app.py for the expected shape; field-level args can be added in a follow-up
+      PR.
+    json: true
+    raw: true
+- id: site_postmaster_delete_domain
+  path: /site/{site}/postmaster/config
+  method: DELETE
+  risk: write
+  audience: customer
+  cli:
+    group:
+    - site
+    - postmaster
+    command: delete-domain
+  mcp:
+    expose: false
+    tool_name: null
+    description: Remove a Postmaster sender domain.
+  body_args:
+  - name: body
+    help: JSON request body. See app.py for the expected shape; field-level args can be added in a follow-up
+      PR.
+    json: true
+    raw: true
+- id: site_postmaster_oauth_callback
+  path: /site/{site}/postmaster/oauth/callback
+  method: POST
+  risk: write
+  audience: customer
+  cli:
+    group:
+    - site
+    - postmaster
+    - oauth
+    command: callback
+  mcp:
+    expose: false
+    tool_name: null
+    description: Complete the Postmaster OAuth flow (machine-driven; rarely called by humans).
+  body_args:
+  - name: body
+    help: JSON request body. See app.py for the expected shape; field-level args can be added in a follow-up
+      PR.
+    json: true
+    raw: true
+- id: site_postmaster_oauth_disconnect
+  path: /site/{site}/postmaster/oauth
+  method: DELETE
+  risk: write
+  audience: customer
+  cli:
+    group:
+    - site
+    - postmaster
+    - oauth
+    command: disconnect
+  mcp:
+    expose: false
+    tool_name: null
+    description: Disconnect Postmaster OAuth.
+- id: site_google_ads_list_campaigns
+  path: /site/{site}/google-ads/campaigns
+  method: POST
+  risk: write
+  audience: customer
+  cli:
+    group:
+    - site
+    - google-ads
+    command: list-campaigns
+  mcp:
+    expose: false
+    tool_name: null
+    description: Trigger a Google Ads campaign list refresh (POST body filters).
+  body_args:
+  - name: body
+    help: JSON request body. See app.py for the expected shape; field-level args can be added in a follow-up
+      PR.
+    json: true
+    raw: true
+- id: site_google_ads_oauth_callback
+  path: /site/{site}/google-ads/oauth/callback
+  method: POST
+  risk: write
+  audience: customer
+  cli:
+    group:
+    - site
+    - google-ads
+    - oauth
+    command: callback
+  mcp:
+    expose: false
+    tool_name: null
+    description: Complete the Google Ads OAuth flow.
+  body_args:
+  - name: body
+    help: JSON request body. See app.py for the expected shape; field-level args can be added in a follow-up
+      PR.
+    json: true
+    raw: true
+- id: site_google_ads_oauth_disconnect
+  path: /site/{site}/google-ads/oauth
+  method: DELETE
+  risk: write
+  audience: customer
+  cli:
+    group:
+    - site
+    - google-ads
+    - oauth
+    command: disconnect
+  mcp:
+    expose: false
+    tool_name: null
+    description: Disconnect Google Ads OAuth.
+- id: site_google_ads_put_config
+  path: /site/{site}/google-ads/config
+  method: PUT
+  risk: write
+  audience: customer
+  cli:
+    group:
+    - site
+    - google-ads
+    command: put-config
+  mcp:
+    expose: false
+    tool_name: null
+    description: Update Google Ads integration config.
+  body_args:
+  - name: body
+    help: JSON request body. See app.py for the expected shape; field-level args can be added in a follow-up
+      PR.
+    json: true
+    raw: true
+- id: site_google_analytics_oauth_disconnect
+  path: /site/{site}/google-analytics/oauth
+  method: DELETE
+  risk: write
+  audience: customer
+  cli:
+    group:
+    - site
+    - google-analytics
+    - oauth
+    command: disconnect
+  mcp:
+    expose: false
+    tool_name: null
+    description: Disconnect Google Analytics OAuth.
+- id: site_google_analytics_put_config
+  path: /site/{site}/google-analytics/config
+  method: PUT
+  risk: write
+  audience: customer
+  cli:
+    group:
+    - site
+    - google-analytics
+    command: put-config
+  mcp:
+    expose: false
+    tool_name: null
+    description: Update Google Analytics integration config.
+  body_args:
+  - name: body
+    help: JSON request body. See app.py for the expected shape; field-level args can be added in a follow-up
+      PR.
+    json: true
+    raw: true
+- id: site_leads_search
+  path: /site/{site}/leads
+  method: POST
+  risk: write
+  audience: customer
+  cli:
+    group:
+    - site
+    - leads
+    command: search
+  mcp:
+    expose: false
+    tool_name: null
+    description: Query leads with a POST body filter.
+  body_args:
+  - name: body
+    help: JSON request body. See app.py for the expected shape; field-level args can be added in a follow-up
+      PR.
+    json: true
+    raw: true
+- id: site_quiz_create
+  path: /site/{site}/quiz
+  method: POST
+  risk: write
+  audience: customer
+  cli:
+    group:
+    - site
+    - quiz
+    command: create
+  mcp:
+    expose: false
+    tool_name: null
+    description: Create a quiz.
+  body_args:
+  - name: body
+    help: JSON request body. See app.py for the expected shape; field-level args can be added in a follow-up
+      PR.
+    json: true
+    raw: true
+- id: site_quiz_update
+  path: /site/{site}/quiz/{quiz_id}
+  method: PUT
+  risk: write
+  audience: customer
+  cli:
+    group:
+    - site
+    - quiz
+    command: update
+  mcp:
+    expose: false
+    tool_name: null
+    description: Replace a quiz.
+  body_args:
+  - name: body
+    help: JSON request body. See app.py for the expected shape; field-level args can be added in a follow-up
+      PR.
+    json: true
+    raw: true
+- id: site_quiz_patch
+  path: /site/{site}/quiz/{quiz_id}
+  method: PATCH
+  risk: write
+  audience: customer
+  cli:
+    group:
+    - site
+    - quiz
+    command: patch
+  mcp:
+    expose: false
+    tool_name: null
+    description: Partial-update a quiz.
+  body_args:
+  - name: body
+    help: JSON request body. See app.py for the expected shape; field-level args can be added in a follow-up
+      PR.
+    json: true
+    raw: true
+- id: site_quiz_delete
+  path: /site/{site}/quiz/{quiz_id}
+  method: DELETE
+  risk: write
+  audience: customer
+  cli:
+    group:
+    - site
+    - quiz
+    command: delete
+  mcp:
+    expose: false
+    tool_name: null
+    description: Delete a quiz.
+- id: site_quiz_build
+  path: /site/{site}/quiz/{quiz_id}/build
+  method: POST
+  risk: write
+  audience: customer
+  cli:
+    group:
+    - site
+    - quiz
+    command: build
+  mcp:
+    expose: false
+    tool_name: null
+    description: Re-build a quiz (no body required).
+- id: site_account_create
+  path: /site/{site}/account
+  method: POST
+  risk: write
+  audience: customer
+  cli:
+    group:
+    - site
+    - account
+    command: create
+  mcp:
+    expose: false
+    tool_name: null
+    description: Create an integration account.
+  body_args:
+  - name: body
+    help: JSON request body. See app.py for the expected shape; field-level args can be added in a follow-up
+      PR.
+    json: true
+    raw: true
+- id: site_account_update
+  path: /site/{site}/account/{account_id}
+  method: PUT
+  risk: write
+  audience: customer
+  cli:
+    group:
+    - site
+    - account
+    command: update
+  mcp:
+    expose: false
+    tool_name: null
+    description: Update an integration account.
+  body_args:
+  - name: body
+    help: JSON request body. See app.py for the expected shape; field-level args can be added in a follow-up
+      PR.
+    json: true
+    raw: true
+- id: site_account_delete
+  path: /site/{site}/account/{account_id}
+  method: DELETE
+  risk: write
+  audience: customer
+  cli:
+    group:
+    - site
+    - account
+    command: delete
+  mcp:
+    expose: false
+    tool_name: null
+    description: Delete an integration account.
+- id: site_weight_put
+  path: /site/{site}/weight/{quiz_id}
+  method: PUT
+  risk: write
+  audience: customer
+  cli:
+    group:
+    - site
+    - weight
+    command: put
+  mcp:
+    expose: false
+    tool_name: null
+    description: Replace a quiz's weight table.
+  body_args:
+  - name: body
+    help: JSON request body. See app.py for the expected shape; field-level args can be added in a follow-up
+      PR.
+    json: true
+    raw: true
+- id: site_email_checker_create
+  path: /site/{site}/email-checker
+  method: POST
+  risk: write
+  audience: customer
+  cli:
+    group:
+    - site
+    - email-checker
+    command: create
+  mcp:
+    expose: false
+    tool_name: null
+    description: Create an email-checker job.
+  body_args:
+  - name: body
+    help: JSON request body. See app.py for the expected shape; field-level args can be added in a follow-up
+      PR.
+    json: true
+    raw: true
+- id: site_email_checker_update
+  path: /site/{site}/email-checker/{checker_id}
+  method: PUT
+  risk: write
+  audience: customer
+  cli:
+    group:
+    - site
+    - email-checker
+    command: update
+  mcp:
+    expose: false
+    tool_name: null
+    description: Update an email-checker job.
+  body_args:
+  - name: body
+    help: JSON request body. See app.py for the expected shape; field-level args can be added in a follow-up
+      PR.
+    json: true
+    raw: true
+- id: site_active_campaign_put_config_user
+  path: /site/{site}/active-campaign/config-user
+  method: PUT
+  risk: write
+  audience: customer
+  cli:
+    group:
+    - site
+    - active-campaign
+    command: put-config-user
+  mcp:
+    expose: false
+    tool_name: null
+    description: Update the per-user ActiveCampaign config.
+  body_args:
+  - name: body
+    help: JSON request body. See app.py for the expected shape; field-level args can be added in a follow-up
+      PR.
+    json: true
+    raw: true
+- id: site_annotations_update
+  path: /site/{site}/annotations/{annotation_id}
+  method: PUT
+  risk: write
+  audience: customer
+  cli:
+    group:
+    - site
+    - annotations
+    command: update
+  mcp:
+    expose: false
+    tool_name: null
+    description: Update an annotation.
+  body_args:
+  - name: body
+    help: JSON request body. See app.py for the expected shape; field-level args can be added in a follow-up
+      PR.
+    json: true
+    raw: true
+- id: site_annotations_delete
+  path: /site/{site}/annotations/{annotation_id}
+  method: DELETE
+  risk: write
+  audience: customer
+  cli:
+    group:
+    - site
+    - annotations
+    command: delete
+  mcp:
+    expose: false
+    tool_name: null
+    description: Delete an annotation.
+- id: site_config_deploy_wrapper
+  path: /site/{site}/config/deploy-config-wrapper
+  method: POST
+  risk: write
+  audience: customer
+  cli:
+    group:
+    - site
+    - config
+    command: deploy-wrapper
+  mcp:
+    expose: false
+    tool_name: null
+    description: 'Save config fields and queue a wrapper deploy with them. The body is
+
+      REQUIRED: every field in it overwrites the site''s saved config (the
+
+      change is kept in the config history), then the wrapper is deployed.
+
+      This is a config write, not a bare trigger. A missing or non-object
+
+      body returns 400 and nothing is saved or deployed.
+
+      '
+  body_args:
+  - name: body
+    help: 'JSON object, REQUIRED: the config to save and deploy (e.g. the `config` object from `site config
+      get`, edited). Send integral numbers as integers: `config get` renders them as floats (networkId
+      4919509 comes back as 4919509.0), and a deployed 4919509.0 ends up in ad unit paths and breaks every
+      ad request on the site. Never paste float-rendered `config get` output (e.g. 5.0) back into a deploy
+      unchanged.'
+    json: true
+    raw: true
+- id: site_email_checker_delete
+  path: /site/{site}/email-checker/{checker_id}
+  method: DELETE
+  risk: write
+  audience: customer
+  cli:
+    group:
+    - site
+    - email-checker
+    command: delete
+  mcp:
+    expose: false
+    tool_name: null
+    description: Delete an email-checker job.
+- id: site_google_adm_start_report
+  path: /site/{site}/google-adm/start-gam-report
+  method: POST
+  risk: write
+  audience: customer
+  cli:
+    group:
+    - site
+    - google-adm
+    command: start-report
+  mcp:
+    expose: false
+    tool_name: null
+    description: Trigger a GAM report run.
+  body_args:
+  - name: body
+    help: JSON request body. See app.py for the expected shape; field-level args can be added in a follow-up
+      PR.
+    json: true
+    raw: true
+- id: site_google_analytics_oauth_callback
+  path: /site/{site}/google-analytics/oauth/callback
+  method: POST
+  risk: write
+  audience: customer
+  cli:
+    group:
+    - site
+    - google-analytics
+    - oauth
+    command: callback
+  mcp:
+    expose: false
+    tool_name: null
+    description: Complete the Google Analytics OAuth flow.
+  body_args:
+  - name: body
+    help: JSON request body. See app.py for the expected shape; field-level args can be added in a follow-up
+      PR.
+    json: true
+    raw: true