---
title: "Switch the Conversions API mirror or single events on and off"
method: PATCH
path: "/api/marketing-rules/settings"
tags: ["marketing-rules"]
---

# Switch the Conversions API mirror or single events on and off

`PATCH /api/marketing-rules/settings`

## Request

- Base URL: `https://api.corabea.it` (the document declares no server; this is the origin it was published from)
- URL: `https://api.corabea.it/api/marketing-rules/settings`
- Auth: HTTP bearer

## Request body

- MarketingRulesSettingsUpdate
  - `master_enabled` boolean, nullable
  - `events` object, nullable

## Response `200`

Successful Response

- MarketingRulesResponse
  - `site` MarketingSiteStatus, required: Mirror of GET /wp-json/corabea/v1/meta-tracking/status.
    - `pixel_id` string, required
    - `api_version` string, required
    - `token_present` boolean, required
    - `test_event_code_set` boolean, required
    - `master_enabled` boolean, required
    - `browser_pixel` boolean
    - `mode` 'pixel+capi' | 'pixel-only' | 'capi-only' | 'off', required
    - `events` MarketingEvent[]
      - `name` string, required
      - `enabled` boolean, required
      - `pages` MarketingPageRef[]
        - `event` string, required
        - `slug` string, required
        - `url` string, required
        - `trigger` string, required
        - `sent_24h` integer, nullable
      - `sent_24h` integer
      - `rejected_24h` integer
      - `failed_24h` integer
      - `disabled_24h` integer
      - `last_sent_at` string, nullable
      - `deliveries` MarketingEventDelivery[]
        - `destination` string, required
        - `remote_name` string, nullable
        - `sent_24h` integer
        - `rejected_24h` integer
        - `failed_24h` integer
        - `disabled_24h` integer
        - `last_sent_at` string, nullable
    - `page_map` MarketingPageRef[]
      - `event` string, required
      - `slug` string, required
      - `url` string, required
      - `trigger` string, required
      - `sent_24h` integer, nullable
    - `last_errors` MarketingError[]
      - `event_name` string, required
      - `error` string, nullable
      - `at` string, required
    - `retention_days` integer, required
    - `generated_at` string, required
  - `platforms` MarketingPlatform[], required
    - `name` string, required
    - `dataset_id` string, required
    - `delivery` 'pixel+capi' | 'pixel-only' | 'capi-only' | 'off' | 'browser-only', required
    - `token_present` boolean, nullable
    - `events_24h_sent` integer, nullable
    - `note` string, nullable
    - `consent` string, nullable
    - `tracked` string[]
  - `app_events` AppEvent[], required
    - `step` string, required
    - `event` string, required
    - `kind` 'standard' | 'custom', required
    - `surface` 'web' | 'native' | 'both', required
    - `spotify_event` string, nullable
  - `capi_log` CapiLog: Outcome log of the relay, from the API database (site and app, every destination).
    - `totals` CapiSourceTotals[], required
      - `destination` 'meta' | 'spotify'
      - `source` 'site' | 'app', required
      - `sent_24h` integer
      - `rejected_24h` integer
      - `failed_24h` integer
      - `disabled_24h` integer
      - `sent_7d` integer
      - `rejected_7d` integer
      - `failed_7d` integer
    - `coverage` CapiEventCoverage[], required
      - `destination` 'meta' | 'spotify'
      - `source` 'site' | 'app', required
      - `event_name` string, required
      - `sent` integer, required
      - `coverage` object, required
    - `daily` CapiDailyPoint[], required
      - `day` string, required
      - `destination` 'meta' | 'spotify'
      - `source` 'site' | 'app', required
      - `status` string, required
      - `n` integer, required
    - `last_errors` CapiLogError[], required
      - `at` string, required
      - `destination` 'meta' | 'spotify'
      - `source` string, required
      - `event_name` string, required
      - `status` string, required
      - `error` string, nullable
    - `app_event_counts_24h` object, required
  - `catalog` EventCatalog
    - `meta` MetaCatalogEntry[], required
      - `name` string, required
      - `site_pages` MarketingPageRef[]
        - `event` string, required
        - `slug` string, required
        - `url` string, required
        - `trigger` string, required
        - `sent_24h` integer, nullable
      - `app_steps` string[]
      - `spotify_name` string, nullable
      - `usage` 'site' | 'app' | 'both' | 'free', required
    - `spotify` SpotifyCatalogEntry[], required
      - `name` string, required
      - `kind` 'standard' | 'custom', required
      - `mapped_from` string[]
      - `free` boolean, required
  - `other_sites` MarketingOtherSite[]
    - `host` string, required
    - `description` string, required
    - `pages` MarketingLandingPage[], required
      - `slug` string, required
      - `url` string, required
      - `actions` string, required
    - `platforms` MarketingPlatform[], required
      - `name` string, required
      - `dataset_id` string, required
      - `delivery` 'pixel+capi' | 'pixel-only' | 'capi-only' | 'off' | 'browser-only', required
      - `token_present` boolean, nullable
      - `events_24h_sent` integer, nullable
      - `note` string, nullable
      - `consent` string, nullable
      - `tracked` string[]
    - `notes` string[]

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-15** `2287045764a7`: 1 info
  - added the optional property `other_sites` to the response with the `200` status
- **2026-10-07** `0be19a2c25c2`: 2 info
  - added the optional property `platforms/items/consent` to the response with the `200` status
  - added the optional property `platforms/items/tracked` to the response with the `200` status
- **2026-09-11** `6afa01417695`: 4 warning, 7 info
  - added the new `capi-only` enum value to the `platforms/items/delivery` response property for the response status `200`
  - added the new `capi-only` enum value to the `site/mode` response property for the response status `200`
  - added the new `off` enum value to the `platforms/items/delivery` response property for the response status `200`
  - added the new `off` enum value to the `site/mode` response property for the response status `200`
  - …7 more
- **2026-09-10** `6c54f9b2a5d3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/corabea/apis/corabea-api/changes/api/marketing-rules/settings/patch.md)

---

[API](https://skmtc.dev/corabea/apis/corabea-api.md) · [All operations](https://skmtc.dev/corabea/apis/corabea-api/llms.txt) · [OpenAPI document](https://skmtc.dev/corabea/apis/corabea-api/revisions/d8cdee1d5474?raw)