DUduda
Personalization Rules

List personalization rules

Returns rules sorted by priority. Rules whose stored conditions or actions are not exposed by this API surface as UNSUPPORTED placeholders with manageableViaApi = false; pass managedOnly=true to hide them.

get/api/sites/multiscreen/site/{site_name}/personalizations

Request

  • Base URL
    https://api.duda.co
  • URL
    https://api.duda.co/api/sites/multiscreen/site/{site_name}/personalizations
  • Auth
    HTTP basic

Path parameters

site_namestring required

The site's unique name (its ID), returned when the site is created.

Query parameters

limitinteger

Page size. Max 200.

offsetinteger

Page offset.

status'DRAFT' | 'ACTIVE' | 'PAUSED'

Lifecycle status. DRAFT = saved but inactive, ACTIVE = running on the site, PAUSED = temporarily disabled.

Optional status filter. Omit to include all statuses.

managedOnlyboolean

If true, only return rules where manageableViaApi is true.

Response

Paginated list of rules

limitinteger

Page size that was applied.

offsetinteger

Offset that was applied.

totalinteger

Total number of rules matching the filter (across all pages).

Example response

{
  "limit": 50,
  "results": [
    {
      "action": {
        "html": "<b>40% OFF this weekend!</b>",
        "background_color": "#FFEB3B",
        "duration_seconds": 5
      },
      "conditions": [
        {
          "visit_number": 1
        }
      ],
      "id": "12345",
      "manageable_via_api": true,
      "name": "Welcome popup for new visitors",
      "priority": 1,
      "show_once": true
    }
  ],
  "total": 42
}

Changes

No recorded changes to this operation across all 1 revision of this API.