**גרסאות API** · [V2 (Latest)](/integrations/v2/docs?lang=he) · **V1**

> **גרסה זו של ה־API מיושנת.** לחיבורים חדשים יש להשתמש בגרסה העדכנית ביותר. [לתיעוד העדכני](/integrations/v2/docs?lang=he)

# Site

OpenAPI 3.0.3 · API 1.0.0

```json
[
  {
    "url": "https://api.unisoft.world/integrations/v1",
    "description": "API"
  }
]
```

Customise the **classic public website** (themes DEFAULT / 2026) — the admin « Thème du site » page. Read with `GET /site`, then edit one section at a time (PATCH). Sections: appearance (theme + colour/font tokens), menu (the 2 header CTA buttons), hero (carousel), banners, home-sections, prefooter-sections, donation-page, seo. The donation-page section covers ALL main /don settings (content, YouTube, background, carousel, preset amounts, main caisse and redirect) and works with Travel and mobile themes too. Multi-façade: every operation accepts `?virtualId=` (omit = main site); discover façades with `GET /site/facades`. Scopes: `site:read` / `site:write`.

## פעולות

## GET /site/facades

List the org's façades (sites)

`list_site_facades`

Required scope: `site:read`. Lists the main site + virtual sites so you know which `virtualId` to pass to the other /site operations.

### אימות

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### הרשאות נדרשות

```json
{
  "accepted": "site:read",
  "additional": []
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SiteFacade"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Missing or invalid key"
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE"
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "site:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /site

Get the classic site theme config

`get_site`

Required scope: `site:read`. Returns the normalised theme config (appearance, menu, hero, banners, homeSections, preFooterSections, donationPage) of the façade in `?virtualId` (omit = main site).

### אימות

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### הרשאות נדרשות

```json
{
  "accepted": "site:read",
  "additional": []
}
```

### פרמטרים

```json
{
  "name": "virtualId",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Façade (virtual site) to target. Omit = the main site. List façades with GET /site/facades."
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/SiteConfig"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "FACADE_NOT_FOUND"
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "site:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## PATCH /site/appearance

Set theme + colour/font tokens

`update_site_appearance`

Required scope: `site:write`. Sets the active `theme` and/or the 2026 `tokens`; each provided field replaces its target. Targets the façade in `?virtualId` (omit = main site).

### אימות

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### הרשאות נדרשות

```json
{
  "accepted": "site:write",
  "additional": []
}
```

### פרמטרים

```json
{
  "name": "virtualId",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Façade (virtual site) to target. Omit = the main site. List façades with GET /site/facades."
}
```

### גוף הבקשה

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SiteAppearance"
      }
    }
  }
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {}
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "VALIDATION_ERROR",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "FACADE_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "site:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /site/seo

Get the site's default SEO

`get_site_seo`

Required scope: `site:read`. Default SEO for the homepage and any public CMS page without its own SEO. Each field resolves independently: explicit page SEO, then this site default, then the existing automatically generated value. Applies to classic, Travel, mobile and campaign themes. Default-language values live at the root; enabled alternate languages use partial overlays. Omitted fields/overlays are preserved; null or an empty string clears an individual value (restores fallback). A null/empty language object removes that overlay only.

### אימות

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### הרשאות נדרשות

```json
{
  "accepted": "site:read",
  "additional": []
}
```

### פרמטרים

```json
{
  "name": "virtualId",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Façade (virtual site) to target. Omit = the main site. List façades with GET /site/facades."
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/SiteSeo"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "FACADE_NOT_FOUND"
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "site:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## PATCH /site/seo

Update the site's default SEO

`update_site_seo`

Required scope: `site:write`. Default SEO for the homepage and any public CMS page without its own SEO. Each field resolves independently: explicit page SEO, then this site default, then the existing automatically generated value. Applies to classic, Travel, mobile and campaign themes. Default-language values live at the root; enabled alternate languages use partial overlays. Omitted fields/overlays are preserved; null or an empty string clears an individual value (restores fallback). A null/empty language object removes that overlay only. Targets the façade in `?virtualId` (omit = main site).

### אימות

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### הרשאות נדרשות

```json
{
  "accepted": "site:write",
  "additional": []
}
```

### פרמטרים

```json
{
  "name": "virtualId",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Façade (virtual site) to target. Omit = the main site. List façades with GET /site/facades."
}
```

### גוף הבקשה

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SiteSeo"
      }
    }
  }
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/SiteSeo"
          }
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "VALIDATION_ERROR"
}
```

#### HTTP 404

```json
{
  "description": "FACADE_NOT_FOUND or NOT_FOUND"
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "site:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /site/donation-page

Get all main donation page settings

`get_site_donation_page`

Required scope: `site:read`. Returns all settings of the main donation page, including alternate-language content/media/preset arrays, the linked main caisse and the main /don redirect. Works with classic, Travel and mobile themes. Also available as donationPage in GET /site. Targets the façade in `?virtualId` (omit = main site).

### אימות

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### הרשאות נדרשות

```json
{
  "accepted": "site:read",
  "additional": []
}
```

### פרמטרים

```json
{
  "name": "virtualId",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Façade (virtual site) to target. Omit = the main site. List façades with GET /site/facades."
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/SiteDonationPage"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "FACADE_NOT_FOUND"
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "site:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## PATCH /site/donation-page

Update all main donation page settings

`update_site_donation_page`

Required scope: `site:write`. Main donation page settings (admin « Ma page de don »), shared by the classic, Travel and mobile themes. Partial update: omitted fields and translations are preserved. Media/preset arrays replace the supplied array. Default-language values live at the root; alternate languages can override the five presentation fields, including whole arrays. A linked mainCaisse supplies its own content/media/presets; redirect takes precedence over the main /don page. This does not change organisation-wide payment-provider settings or campaign configuration. Omitted fields within a language overlay are preserved too. Send a language as null or {} to delete only this page's translations for that language, preserving other website translations. Null on an individual translated text/image clears that override; [] empties a translated array. Images are re-hosted in root and alternate languages; an import failure rejects the update. Unknown fields, disabled language overlays and non-translatable routing fields in an overlay are rejected. The mainCaisse must belong to this organisation. Use GET /me to discover defaultLanguage/enabledLanguages. Manage global payment providers separately. Targets the façade in `?virtualId` (omit = main site).

### אימות

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### הרשאות נדרשות

```json
{
  "accepted": "site:write",
  "additional": []
}
```

### פרמטרים

```json
{
  "name": "virtualId",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Façade (virtual site) to target. Omit = the main site. List façades with GET /site/facades."
}
```

### גוף הבקשה

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SiteDonationPage"
      }
    }
  }
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/SiteDonationPage"
          }
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "VALIDATION_ERROR",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "FACADE_NOT_FOUND, CAISSE_NOT_FOUND or NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "site:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## PATCH /site/menu

Set the header CTA buttons

`update_site_menu`

Required scope: `site:write`. Replaces the two header call-to-action buttons (send the full object). Targets the façade in `?virtualId` (omit = main site).

### אימות

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### הרשאות נדרשות

```json
{
  "accepted": "site:write",
  "additional": []
}
```

### פרמטרים

```json
{
  "name": "virtualId",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Façade (virtual site) to target. Omit = the main site. List façades with GET /site/facades."
}
```

### גוף הבקשה

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SiteMenu"
      }
    }
  }
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {}
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "VALIDATION_ERROR",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "FACADE_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "site:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## PATCH /site/hero

Set the hero carousel slides

`update_site_hero`

Required scope: `site:write`. Replaces the whole hero carousel with the supplied `slides` array. Targets the façade in `?virtualId` (omit = main site).

### אימות

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### הרשאות נדרשות

```json
{
  "accepted": "site:write",
  "additional": []
}
```

### פרמטרים

```json
{
  "name": "virtualId",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Façade (virtual site) to target. Omit = the main site. List façades with GET /site/facades."
}
```

### גוף הבקשה

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "slides"
        ],
        "properties": {
          "slides": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SiteSlide"
            },
            "description": "Ordered hero slides (replaces the carousel)."
          }
        }
      }
    }
  }
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {}
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "VALIDATION_ERROR",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "FACADE_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "site:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## PATCH /site/banners

Set the promo banners

`update_site_banners`

Required scope: `site:write`. Replaces the promo banners with the supplied `items` array. Targets the façade in `?virtualId` (omit = main site).

### אימות

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### הרשאות נדרשות

```json
{
  "accepted": "site:write",
  "additional": []
}
```

### פרמטרים

```json
{
  "name": "virtualId",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Façade (virtual site) to target. Omit = the main site. List façades with GET /site/facades."
}
```

### גוף הבקשה

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "items"
        ],
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SiteSlide"
            },
            "description": "Promo banners (replaces them all)."
          }
        }
      }
    }
  }
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {}
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "VALIDATION_ERROR",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "FACADE_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "site:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## PATCH /site/home-sections

Set the home page sections

`update_site_home_sections`

Required scope: `site:write`. Replaces the home page composition with the supplied `sections` array (order = on-page order). GET /site first to keep the built-in sections + ids. A CUSTOM_CONTENT section with props.contentType="AI" references an aiContentBlockId — write its HTML via PUT /content-blocks/{id}/content. Targets the façade in `?virtualId` (omit = main site).

### אימות

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### הרשאות נדרשות

```json
{
  "accepted": "site:write",
  "additional": []
}
```

### פרמטרים

```json
{
  "name": "virtualId",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Façade (virtual site) to target. Omit = the main site. List façades with GET /site/facades."
}
```

### גוף הבקשה

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "sections"
        ],
        "properties": {
          "sections": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SiteSection"
            },
            "description": "Ordered home sections (replaces the composition)."
          }
        }
      }
    }
  }
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {}
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "VALIDATION_ERROR",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "FACADE_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "site:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## PATCH /site/prefooter-sections

Set the pre-footer sections

`update_site_prefooter_sections`

Required scope: `site:write`. Replaces the sections shown before the footer on every page. Targets the façade in `?virtualId` (omit = main site).

### אימות

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### הרשאות נדרשות

```json
{
  "accepted": "site:write",
  "additional": []
}
```

### פרמטרים

```json
{
  "name": "virtualId",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Façade (virtual site) to target. Omit = the main site. List façades with GET /site/facades."
}
```

### גוף הבקשה

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "sections"
        ],
        "properties": {
          "sections": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SiteSection"
            },
            "description": "Ordered pre-footer sections (replaces them all)."
          }
        }
      }
    }
  }
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {}
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "VALIDATION_ERROR",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "FACADE_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "site:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## סכמות

```json
{
  "components": {
    "schemas": {
      "SiteFacade": {
        "type": "object",
        "description": "A façade = a public site of the org. The main site has virtualId=null; each virtual site has its own id.",
        "properties": {
          "virtualId": {
            "type": "string",
            "nullable": true,
            "description": "Pass this value as `?virtualId=` to target the façade. null = main site."
          },
          "label": {
            "type": "string"
          }
        }
      },
      "SiteConfig": {
        "type": "object",
        "description": "Normalised classic-website theme config of one façade (1:1 with the PATCH /site/* sections).",
        "properties": {
          "appearance": {
            "$ref": "#/components/schemas/SiteAppearance"
          },
          "menu": {
            "$ref": "#/components/schemas/SiteMenu"
          },
          "hero": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SiteSlide"
            }
          },
          "banners": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SiteSlide"
            }
          },
          "homeSections": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SiteSection"
            }
          },
          "preFooterSections": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SiteSection"
            }
          },
          "donationPage": {
            "$ref": "#/components/schemas/SiteDonationPage"
          },
          "seo": {
            "$ref": "#/components/schemas/SiteSeo"
          }
        }
      },
      "SiteAppearance": {
        "type": "object",
        "properties": {
          "theme": {
            "type": "string",
            "enum": [
              "DEFAULT",
              "2026"
            ],
            "description": "Active theme of the classic website. \"DEFAULT\" = the classic Ummah theme; \"2026\" = the modern theme (uses `tokens`, supports hero/sections/banners/header buttons)."
          },
          "tokens": {
            "type": "object",
            "properties": {
              "primary": {
                "type": "string",
                "description": "Primary brand colour (hex), e.g. \"#1B2A4E\"."
              },
              "secondary": {
                "type": "string",
                "description": "Secondary / accent colour (hex)."
              },
              "bg": {
                "type": "string",
                "description": "Page background colour (hex)."
              },
              "surface": {
                "type": "string",
                "description": "Card/surface background colour (hex)."
              },
              "ink": {
                "type": "string",
                "description": "Primary text colour (hex)."
              },
              "fontDisplay": {
                "type": "string",
                "description": "Headings font stack, e.g. \"Fraunces, ui-serif, Georgia, serif\"."
              },
              "fontBody": {
                "type": "string",
                "description": "Body font stack, e.g. \"Inter, system-ui, sans-serif\"."
              }
            },
            "description": "Design tokens of the 2026 theme, injected as CSS variables on the public site. Colours are hex strings; fonts are CSS font-family stacks (Google Fonts allowed). Omit a token to keep its default."
          }
        },
        "description": "Overall look of the classic website: which theme is active and the 2026 colour/font tokens. Send `theme` and/or `tokens` — each provided field replaces its target (theme → org.web.theme, tokens → org.web.theme2026.tokens)."
      },
      "SiteMenu": {
        "type": "object",
        "properties": {
          "button_1_label": {
            "type": "string",
            "description": "Label of the first header button (e.g. \"Don\")."
          },
          "button_1_url": {
            "type": "string",
            "description": "Target of the first button: an internal path (\"/don\") or a full URL."
          },
          "button_1_icon": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Icon name within the library (e.g. \"IconMapPin\")."
              },
              "source": {
                "type": "string",
                "description": "Icon library, e.g. \"tabler\"."
              }
            },
            "description": "Icon of the first button."
          },
          "button_2_label": {
            "type": "string",
            "description": "Label of the second header button (empty = no second button)."
          },
          "button_2_url": {
            "type": "string",
            "description": "Target of the second button."
          },
          "button_2_icon": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Icon name within the library (e.g. \"IconMapPin\")."
              },
              "source": {
                "type": "string",
                "description": "Icon library, e.g. \"tabler\"."
              }
            },
            "description": "Icon of the second button."
          },
          "fr": {
            "type": "object",
            "nullable": true,
            "description": "Translation overlay holding ONLY the translatable fields of this object for one alternate language. The value in the organisation's DEFAULT language stays at the ROOT of the object — it is NOT nested under its own language key. Valid overlay languages are the org's enabled languages minus the default one (WRITING the default language as an overlay is rejected; sending it as null to DELETE a stale overlay is allowed — an org that changed its default language can be left with one). Send this object to create or overwrite that language's translation. Set it to **null** to DELETE the whole overlay for that language: omitting the key means \"leave the existing translation as it is\" on a partial update, so null is the ONLY way to remove one. An empty object ({}) is treated as a deletion too.",
            "properties": {
              "button_1_label": {
                "type": "string",
                "description": "Label of the first header button (e.g. \"Don\")."
              },
              "button_2_label": {
                "type": "string",
                "description": "Label of the second header button (empty = no second button)."
              }
            }
          },
          "en": {
            "type": "object",
            "nullable": true,
            "description": "Translation overlay holding ONLY the translatable fields of this object for one alternate language. The value in the organisation's DEFAULT language stays at the ROOT of the object — it is NOT nested under its own language key. Valid overlay languages are the org's enabled languages minus the default one (WRITING the default language as an overlay is rejected; sending it as null to DELETE a stale overlay is allowed — an org that changed its default language can be left with one). Send this object to create or overwrite that language's translation. Set it to **null** to DELETE the whole overlay for that language: omitting the key means \"leave the existing translation as it is\" on a partial update, so null is the ONLY way to remove one. An empty object ({}) is treated as a deletion too.",
            "properties": {
              "button_1_label": {
                "type": "string",
                "description": "Label of the first header button (e.g. \"Don\")."
              },
              "button_2_label": {
                "type": "string",
                "description": "Label of the second header button (empty = no second button)."
              }
            }
          },
          "he": {
            "type": "object",
            "nullable": true,
            "description": "Translation overlay holding ONLY the translatable fields of this object for one alternate language. The value in the organisation's DEFAULT language stays at the ROOT of the object — it is NOT nested under its own language key. Valid overlay languages are the org's enabled languages minus the default one (WRITING the default language as an overlay is rejected; sending it as null to DELETE a stale overlay is allowed — an org that changed its default language can be left with one). Send this object to create or overwrite that language's translation. Set it to **null** to DELETE the whole overlay for that language: omitting the key means \"leave the existing translation as it is\" on a partial update, so null is the ONLY way to remove one. An empty object ({}) is treated as a deletion too.",
            "properties": {
              "button_1_label": {
                "type": "string",
                "description": "Label of the first header button (e.g. \"Don\")."
              },
              "button_2_label": {
                "type": "string",
                "description": "Label of the second header button (empty = no second button)."
              }
            }
          },
          "it": {
            "type": "object",
            "nullable": true,
            "description": "Translation overlay holding ONLY the translatable fields of this object for one alternate language. The value in the organisation's DEFAULT language stays at the ROOT of the object — it is NOT nested under its own language key. Valid overlay languages are the org's enabled languages minus the default one (WRITING the default language as an overlay is rejected; sending it as null to DELETE a stale overlay is allowed — an org that changed its default language can be left with one). Send this object to create or overwrite that language's translation. Set it to **null** to DELETE the whole overlay for that language: omitting the key means \"leave the existing translation as it is\" on a partial update, so null is the ONLY way to remove one. An empty object ({}) is treated as a deletion too.",
            "properties": {
              "button_1_label": {
                "type": "string",
                "description": "Label of the first header button (e.g. \"Don\")."
              },
              "button_2_label": {
                "type": "string",
                "description": "Label of the second header button (empty = no second button)."
              }
            }
          },
          "ru": {
            "type": "object",
            "nullable": true,
            "description": "Translation overlay holding ONLY the translatable fields of this object for one alternate language. The value in the organisation's DEFAULT language stays at the ROOT of the object — it is NOT nested under its own language key. Valid overlay languages are the org's enabled languages minus the default one (WRITING the default language as an overlay is rejected; sending it as null to DELETE a stale overlay is allowed — an org that changed its default language can be left with one). Send this object to create or overwrite that language's translation. Set it to **null** to DELETE the whole overlay for that language: omitting the key means \"leave the existing translation as it is\" on a partial update, so null is the ONLY way to remove one. An empty object ({}) is treated as a deletion too.",
            "properties": {
              "button_1_label": {
                "type": "string",
                "description": "Label of the first header button (e.g. \"Don\")."
              },
              "button_2_label": {
                "type": "string",
                "description": "Label of the second header button (empty = no second button)."
              }
            }
          },
          "pt": {
            "type": "object",
            "nullable": true,
            "description": "Translation overlay holding ONLY the translatable fields of this object for one alternate language. The value in the organisation's DEFAULT language stays at the ROOT of the object — it is NOT nested under its own language key. Valid overlay languages are the org's enabled languages minus the default one (WRITING the default language as an overlay is rejected; sending it as null to DELETE a stale overlay is allowed — an org that changed its default language can be left with one). Send this object to create or overwrite that language's translation. Set it to **null** to DELETE the whole overlay for that language: omitting the key means \"leave the existing translation as it is\" on a partial update, so null is the ONLY way to remove one. An empty object ({}) is treated as a deletion too.",
            "properties": {
              "button_1_label": {
                "type": "string",
                "description": "Label of the first header button (e.g. \"Don\")."
              },
              "button_2_label": {
                "type": "string",
                "description": "Label of the second header button (empty = no second button)."
              }
            }
          },
          "de": {
            "type": "object",
            "nullable": true,
            "description": "Translation overlay holding ONLY the translatable fields of this object for one alternate language. The value in the organisation's DEFAULT language stays at the ROOT of the object — it is NOT nested under its own language key. Valid overlay languages are the org's enabled languages minus the default one (WRITING the default language as an overlay is rejected; sending it as null to DELETE a stale overlay is allowed — an org that changed its default language can be left with one). Send this object to create or overwrite that language's translation. Set it to **null** to DELETE the whole overlay for that language: omitting the key means \"leave the existing translation as it is\" on a partial update, so null is the ONLY way to remove one. An empty object ({}) is treated as a deletion too.",
            "properties": {
              "button_1_label": {
                "type": "string",
                "description": "Label of the first header button (e.g. \"Don\")."
              },
              "button_2_label": {
                "type": "string",
                "description": "Label of the second header button (empty = no second button)."
              }
            }
          },
          "es": {
            "type": "object",
            "nullable": true,
            "description": "Translation overlay holding ONLY the translatable fields of this object for one alternate language. The value in the organisation's DEFAULT language stays at the ROOT of the object — it is NOT nested under its own language key. Valid overlay languages are the org's enabled languages minus the default one (WRITING the default language as an overlay is rejected; sending it as null to DELETE a stale overlay is allowed — an org that changed its default language can be left with one). Send this object to create or overwrite that language's translation. Set it to **null** to DELETE the whole overlay for that language: omitting the key means \"leave the existing translation as it is\" on a partial update, so null is the ONLY way to remove one. An empty object ({}) is treated as a deletion too.",
            "properties": {
              "button_1_label": {
                "type": "string",
                "description": "Label of the first header button (e.g. \"Don\")."
              },
              "button_2_label": {
                "type": "string",
                "description": "Label of the second header button (empty = no second button)."
              }
            }
          },
          "gr": {
            "type": "object",
            "nullable": true,
            "description": "Translation overlay holding ONLY the translatable fields of this object for one alternate language. The value in the organisation's DEFAULT language stays at the ROOT of the object — it is NOT nested under its own language key. Valid overlay languages are the org's enabled languages minus the default one (WRITING the default language as an overlay is rejected; sending it as null to DELETE a stale overlay is allowed — an org that changed its default language can be left with one). Send this object to create or overwrite that language's translation. Set it to **null** to DELETE the whole overlay for that language: omitting the key means \"leave the existing translation as it is\" on a partial update, so null is the ONLY way to remove one. An empty object ({}) is treated as a deletion too.",
            "properties": {
              "button_1_label": {
                "type": "string",
                "description": "Label of the first header button (e.g. \"Don\")."
              },
              "button_2_label": {
                "type": "string",
                "description": "Label of the second header button (empty = no second button)."
              }
            }
          },
          "ro": {
            "type": "object",
            "nullable": true,
            "description": "Translation overlay holding ONLY the translatable fields of this object for one alternate language. The value in the organisation's DEFAULT language stays at the ROOT of the object — it is NOT nested under its own language key. Valid overlay languages are the org's enabled languages minus the default one (WRITING the default language as an overlay is rejected; sending it as null to DELETE a stale overlay is allowed — an org that changed its default language can be left with one). Send this object to create or overwrite that language's translation. Set it to **null** to DELETE the whole overlay for that language: omitting the key means \"leave the existing translation as it is\" on a partial update, so null is the ONLY way to remove one. An empty object ({}) is treated as a deletion too.",
            "properties": {
              "button_1_label": {
                "type": "string",
                "description": "Label of the first header button (e.g. \"Don\")."
              },
              "button_2_label": {
                "type": "string",
                "description": "Label of the second header button (empty = no second button)."
              }
            }
          }
        },
        "description": "The two call-to-action buttons shown in the website header (NOT the navigation tree — that is the separate Menu resource). Button 2 is optional (leave its label empty to hide it)."
      },
      "SiteSlide": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "image": {
            "type": "string",
            "description": "Background image of the slide (required). Image: http(s) URL (re-hosted server-side) or an already-hosted \"md5.ext\" filename."
          },
          "eyebrow_icon": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Icon name within the library (e.g. \"IconMapPin\")."
              },
              "source": {
                "type": "string",
                "description": "Icon library, e.g. \"tabler\"."
              }
            },
            "description": "Small icon shown next to the eyebrow text."
          },
          "eyebrow": {
            "type": "string",
            "description": "Small kicker/overline text above the title (e.g. \"An Unforgettable Journey\")."
          },
          "title": {
            "type": "string",
            "description": "Main headline of the slide."
          },
          "subtitle": {
            "type": "string",
            "description": "Secondary line under the title."
          },
          "description": {
            "type": "string",
            "description": "Longer descriptive paragraph for the slide."
          },
          "btn1_label": {
            "type": "string",
            "description": "Label of the first call-to-action button (empty = no button)."
          },
          "btn1_url": {
            "type": "string",
            "description": "Target URL of the first button."
          },
          "btn1_icon": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Icon name within the library (e.g. \"IconMapPin\")."
              },
              "source": {
                "type": "string",
                "description": "Icon library, e.g. \"tabler\"."
              }
            },
            "description": "Icon for the first button."
          },
          "btn2_label": {
            "type": "string",
            "description": "Label of the second call-to-action button (empty = no button)."
          },
          "btn2_url": {
            "type": "string",
            "description": "Target URL of the second button."
          },
          "btn2_icon": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Icon name within the library (e.g. \"IconMapPin\")."
              },
              "source": {
                "type": "string",
                "description": "Icon library, e.g. \"tabler\"."
              }
            },
            "description": "Icon for the second button."
          },
          "fr": {
            "type": "object",
            "nullable": true,
            "description": "Translation overlay holding ONLY the translatable fields of this object for one alternate language. The value in the organisation's DEFAULT language stays at the ROOT of the object — it is NOT nested under its own language key. Valid overlay languages are the org's enabled languages minus the default one (WRITING the default language as an overlay is rejected; sending it as null to DELETE a stale overlay is allowed — an org that changed its default language can be left with one). Send this object to create or overwrite that language's translation. Set it to **null** to DELETE the whole overlay for that language: omitting the key means \"leave the existing translation as it is\" on a partial update, so null is the ONLY way to remove one. An empty object ({}) is treated as a deletion too.",
            "properties": {
              "eyebrow": {
                "type": "string",
                "description": "Small kicker/overline text above the title (e.g. \"An Unforgettable Journey\")."
              },
              "title": {
                "type": "string",
                "description": "Main headline of the slide."
              },
              "subtitle": {
                "type": "string",
                "description": "Secondary line under the title."
              },
              "description": {
                "type": "string",
                "description": "Longer descriptive paragraph for the slide."
              },
              "btn1_label": {
                "type": "string",
                "description": "Label of the first call-to-action button (empty = no button)."
              },
              "btn2_label": {
                "type": "string",
                "description": "Label of the second call-to-action button (empty = no button)."
              }
            }
          },
          "en": {
            "type": "object",
            "nullable": true,
            "description": "Translation overlay holding ONLY the translatable fields of this object for one alternate language. The value in the organisation's DEFAULT language stays at the ROOT of the object — it is NOT nested under its own language key. Valid overlay languages are the org's enabled languages minus the default one (WRITING the default language as an overlay is rejected; sending it as null to DELETE a stale overlay is allowed — an org that changed its default language can be left with one). Send this object to create or overwrite that language's translation. Set it to **null** to DELETE the whole overlay for that language: omitting the key means \"leave the existing translation as it is\" on a partial update, so null is the ONLY way to remove one. An empty object ({}) is treated as a deletion too.",
            "properties": {
              "eyebrow": {
                "type": "string",
                "description": "Small kicker/overline text above the title (e.g. \"An Unforgettable Journey\")."
              },
              "title": {
                "type": "string",
                "description": "Main headline of the slide."
              },
              "subtitle": {
                "type": "string",
                "description": "Secondary line under the title."
              },
              "description": {
                "type": "string",
                "description": "Longer descriptive paragraph for the slide."
              },
              "btn1_label": {
                "type": "string",
                "description": "Label of the first call-to-action button (empty = no button)."
              },
              "btn2_label": {
                "type": "string",
                "description": "Label of the second call-to-action button (empty = no button)."
              }
            }
          },
          "he": {
            "type": "object",
            "nullable": true,
            "description": "Translation overlay holding ONLY the translatable fields of this object for one alternate language. The value in the organisation's DEFAULT language stays at the ROOT of the object — it is NOT nested under its own language key. Valid overlay languages are the org's enabled languages minus the default one (WRITING the default language as an overlay is rejected; sending it as null to DELETE a stale overlay is allowed — an org that changed its default language can be left with one). Send this object to create or overwrite that language's translation. Set it to **null** to DELETE the whole overlay for that language: omitting the key means \"leave the existing translation as it is\" on a partial update, so null is the ONLY way to remove one. An empty object ({}) is treated as a deletion too.",
            "properties": {
              "eyebrow": {
                "type": "string",
                "description": "Small kicker/overline text above the title (e.g. \"An Unforgettable Journey\")."
              },
              "title": {
                "type": "string",
                "description": "Main headline of the slide."
              },
              "subtitle": {
                "type": "string",
                "description": "Secondary line under the title."
              },
              "description": {
                "type": "string",
                "description": "Longer descriptive paragraph for the slide."
              },
              "btn1_label": {
                "type": "string",
                "description": "Label of the first call-to-action button (empty = no button)."
              },
              "btn2_label": {
                "type": "string",
                "description": "Label of the second call-to-action button (empty = no button)."
              }
            }
          },
          "it": {
            "type": "object",
            "nullable": true,
            "description": "Translation overlay holding ONLY the translatable fields of this object for one alternate language. The value in the organisation's DEFAULT language stays at the ROOT of the object — it is NOT nested under its own language key. Valid overlay languages are the org's enabled languages minus the default one (WRITING the default language as an overlay is rejected; sending it as null to DELETE a stale overlay is allowed — an org that changed its default language can be left with one). Send this object to create or overwrite that language's translation. Set it to **null** to DELETE the whole overlay for that language: omitting the key means \"leave the existing translation as it is\" on a partial update, so null is the ONLY way to remove one. An empty object ({}) is treated as a deletion too.",
            "properties": {
              "eyebrow": {
                "type": "string",
                "description": "Small kicker/overline text above the title (e.g. \"An Unforgettable Journey\")."
              },
              "title": {
                "type": "string",
                "description": "Main headline of the slide."
              },
              "subtitle": {
                "type": "string",
                "description": "Secondary line under the title."
              },
              "description": {
                "type": "string",
                "description": "Longer descriptive paragraph for the slide."
              },
              "btn1_label": {
                "type": "string",
                "description": "Label of the first call-to-action button (empty = no button)."
              },
              "btn2_label": {
                "type": "string",
                "description": "Label of the second call-to-action button (empty = no button)."
              }
            }
          },
          "ru": {
            "type": "object",
            "nullable": true,
            "description": "Translation overlay holding ONLY the translatable fields of this object for one alternate language. The value in the organisation's DEFAULT language stays at the ROOT of the object — it is NOT nested under its own language key. Valid overlay languages are the org's enabled languages minus the default one (WRITING the default language as an overlay is rejected; sending it as null to DELETE a stale overlay is allowed — an org that changed its default language can be left with one). Send this object to create or overwrite that language's translation. Set it to **null** to DELETE the whole overlay for that language: omitting the key means \"leave the existing translation as it is\" on a partial update, so null is the ONLY way to remove one. An empty object ({}) is treated as a deletion too.",
            "properties": {
              "eyebrow": {
                "type": "string",
                "description": "Small kicker/overline text above the title (e.g. \"An Unforgettable Journey\")."
              },
              "title": {
                "type": "string",
                "description": "Main headline of the slide."
              },
              "subtitle": {
                "type": "string",
                "description": "Secondary line under the title."
              },
              "description": {
                "type": "string",
                "description": "Longer descriptive paragraph for the slide."
              },
              "btn1_label": {
                "type": "string",
                "description": "Label of the first call-to-action button (empty = no button)."
              },
              "btn2_label": {
                "type": "string",
                "description": "Label of the second call-to-action button (empty = no button)."
              }
            }
          },
          "pt": {
            "type": "object",
            "nullable": true,
            "description": "Translation overlay holding ONLY the translatable fields of this object for one alternate language. The value in the organisation's DEFAULT language stays at the ROOT of the object — it is NOT nested under its own language key. Valid overlay languages are the org's enabled languages minus the default one (WRITING the default language as an overlay is rejected; sending it as null to DELETE a stale overlay is allowed — an org that changed its default language can be left with one). Send this object to create or overwrite that language's translation. Set it to **null** to DELETE the whole overlay for that language: omitting the key means \"leave the existing translation as it is\" on a partial update, so null is the ONLY way to remove one. An empty object ({}) is treated as a deletion too.",
            "properties": {
              "eyebrow": {
                "type": "string",
                "description": "Small kicker/overline text above the title (e.g. \"An Unforgettable Journey\")."
              },
              "title": {
                "type": "string",
                "description": "Main headline of the slide."
              },
              "subtitle": {
                "type": "string",
                "description": "Secondary line under the title."
              },
              "description": {
                "type": "string",
                "description": "Longer descriptive paragraph for the slide."
              },
              "btn1_label": {
                "type": "string",
                "description": "Label of the first call-to-action button (empty = no button)."
              },
              "btn2_label": {
                "type": "string",
                "description": "Label of the second call-to-action button (empty = no button)."
              }
            }
          },
          "de": {
            "type": "object",
            "nullable": true,
            "description": "Translation overlay holding ONLY the translatable fields of this object for one alternate language. The value in the organisation's DEFAULT language stays at the ROOT of the object — it is NOT nested under its own language key. Valid overlay languages are the org's enabled languages minus the default one (WRITING the default language as an overlay is rejected; sending it as null to DELETE a stale overlay is allowed — an org that changed its default language can be left with one). Send this object to create or overwrite that language's translation. Set it to **null** to DELETE the whole overlay for that language: omitting the key means \"leave the existing translation as it is\" on a partial update, so null is the ONLY way to remove one. An empty object ({}) is treated as a deletion too.",
            "properties": {
              "eyebrow": {
                "type": "string",
                "description": "Small kicker/overline text above the title (e.g. \"An Unforgettable Journey\")."
              },
              "title": {
                "type": "string",
                "description": "Main headline of the slide."
              },
              "subtitle": {
                "type": "string",
                "description": "Secondary line under the title."
              },
              "description": {
                "type": "string",
                "description": "Longer descriptive paragraph for the slide."
              },
              "btn1_label": {
                "type": "string",
                "description": "Label of the first call-to-action button (empty = no button)."
              },
              "btn2_label": {
                "type": "string",
                "description": "Label of the second call-to-action button (empty = no button)."
              }
            }
          },
          "es": {
            "type": "object",
            "nullable": true,
            "description": "Translation overlay holding ONLY the translatable fields of this object for one alternate language. The value in the organisation's DEFAULT language stays at the ROOT of the object — it is NOT nested under its own language key. Valid overlay languages are the org's enabled languages minus the default one (WRITING the default language as an overlay is rejected; sending it as null to DELETE a stale overlay is allowed — an org that changed its default language can be left with one). Send this object to create or overwrite that language's translation. Set it to **null** to DELETE the whole overlay for that language: omitting the key means \"leave the existing translation as it is\" on a partial update, so null is the ONLY way to remove one. An empty object ({}) is treated as a deletion too.",
            "properties": {
              "eyebrow": {
                "type": "string",
                "description": "Small kicker/overline text above the title (e.g. \"An Unforgettable Journey\")."
              },
              "title": {
                "type": "string",
                "description": "Main headline of the slide."
              },
              "subtitle": {
                "type": "string",
                "description": "Secondary line under the title."
              },
              "description": {
                "type": "string",
                "description": "Longer descriptive paragraph for the slide."
              },
              "btn1_label": {
                "type": "string",
                "description": "Label of the first call-to-action button (empty = no button)."
              },
              "btn2_label": {
                "type": "string",
                "description": "Label of the second call-to-action button (empty = no button)."
              }
            }
          },
          "gr": {
            "type": "object",
            "nullable": true,
            "description": "Translation overlay holding ONLY the translatable fields of this object for one alternate language. The value in the organisation's DEFAULT language stays at the ROOT of the object — it is NOT nested under its own language key. Valid overlay languages are the org's enabled languages minus the default one (WRITING the default language as an overlay is rejected; sending it as null to DELETE a stale overlay is allowed — an org that changed its default language can be left with one). Send this object to create or overwrite that language's translation. Set it to **null** to DELETE the whole overlay for that language: omitting the key means \"leave the existing translation as it is\" on a partial update, so null is the ONLY way to remove one. An empty object ({}) is treated as a deletion too.",
            "properties": {
              "eyebrow": {
                "type": "string",
                "description": "Small kicker/overline text above the title (e.g. \"An Unforgettable Journey\")."
              },
              "title": {
                "type": "string",
                "description": "Main headline of the slide."
              },
              "subtitle": {
                "type": "string",
                "description": "Secondary line under the title."
              },
              "description": {
                "type": "string",
                "description": "Longer descriptive paragraph for the slide."
              },
              "btn1_label": {
                "type": "string",
                "description": "Label of the first call-to-action button (empty = no button)."
              },
              "btn2_label": {
                "type": "string",
                "description": "Label of the second call-to-action button (empty = no button)."
              }
            }
          },
          "ro": {
            "type": "object",
            "nullable": true,
            "description": "Translation overlay holding ONLY the translatable fields of this object for one alternate language. The value in the organisation's DEFAULT language stays at the ROOT of the object — it is NOT nested under its own language key. Valid overlay languages are the org's enabled languages minus the default one (WRITING the default language as an overlay is rejected; sending it as null to DELETE a stale overlay is allowed — an org that changed its default language can be left with one). Send this object to create or overwrite that language's translation. Set it to **null** to DELETE the whole overlay for that language: omitting the key means \"leave the existing translation as it is\" on a partial update, so null is the ONLY way to remove one. An empty object ({}) is treated as a deletion too.",
            "properties": {
              "eyebrow": {
                "type": "string",
                "description": "Small kicker/overline text above the title (e.g. \"An Unforgettable Journey\")."
              },
              "title": {
                "type": "string",
                "description": "Main headline of the slide."
              },
              "subtitle": {
                "type": "string",
                "description": "Secondary line under the title."
              },
              "description": {
                "type": "string",
                "description": "Longer descriptive paragraph for the slide."
              },
              "btn1_label": {
                "type": "string",
                "description": "Label of the first call-to-action button (empty = no button)."
              },
              "btn2_label": {
                "type": "string",
                "description": "Label of the second call-to-action button (empty = no button)."
              }
            }
          }
        },
        "description": "A hero/banner slide: background image + headline texts + up to two CTA buttons. Translatable texts use the i18n overlay convention.",
        "required": [
          "image"
        ]
      },
      "SiteSection": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "type": {
            "type": "string",
            "enum": [
              "EVENTS_PREVIEW",
              "CAISSES_PREVIEW",
              "HORAIRES_PREVIEW",
              "ARTICLES_PREVIEW",
              "GALLERY_PREVIEW",
              "BANNERS",
              "DONATION_STRIP",
              "CONTACT_BLOCK",
              "NEWSLETTER",
              "MAIN_CONTENT",
              "CUSTOM_CONTENT",
              "SHABBAT_TIMES",
              "ZMANIM"
            ],
            "description": "Section type. *_PREVIEW = a teaser of events/caisses/horaires/articles/gallery; BANNERS = the promo banners strip; DONATION_STRIP/NEWSLETTER/CONTACT_BLOCK = ready-made blocks; MAIN_CONTENT = the home rich-editor page; CUSTOM_CONTENT = a free AI/editor block; SHABBAT_TIMES = next-Shabbat times (candle lighting, havdalah, parasha) auto-computed for the org location, with a `style` (BANNER|CARD|TILES) and an optional CTA (ctaLabel + ctaUrl); ZMANIM = today's halakhic times (zmanim: alot hashahar, netz, sof zman shma, hatsot, plag, shkia, tset…) auto-computed for the org location, with an optional `limit`."
          },
          "label": {
            "type": "string",
            "description": "Admin-facing label of the section (display only)."
          },
          "hidden": {
            "type": "boolean",
            "description": "Hide the section without removing it."
          },
          "editable": {
            "type": "boolean",
            "description": "Admin-UI flag (built-in sections are non-removable). Pass-through; usually left as returned by GET."
          },
          "props": {
            "type": "object",
            "properties": {
              "eyebrow": {
                "type": "string",
                "description": "Small kicker/overline text above the title."
              },
              "title": {
                "type": "string",
                "description": "Section title."
              },
              "subtitle": {
                "type": "string",
                "description": "Section subtitle."
              },
              "description": {
                "type": "string",
                "description": "Section descriptive paragraph."
              },
              "ctaLabel": {
                "type": "string",
                "description": "Call-to-action button label."
              },
              "ctaUrl": {
                "type": "string",
                "description": "Call-to-action target (internal path or full URL)."
              },
              "limit": {
                "type": "number",
                "description": "Max number of items to preview (PREVIEW sections)."
              },
              "style": {
                "type": "string",
                "enum": [
                  "BANNER",
                  "CARD",
                  "TILES"
                ],
                "description": "For SHABBAT_TIMES: visual layout — \"BANNER\" (full-width strip, default), \"CARD\" (centered card), \"TILES\" (parasha header + two big time tiles)."
              },
              "contentType": {
                "type": "string",
                "enum": [
                  "EDITOR",
                  "AI"
                ],
                "description": "For CUSTOM_CONTENT: \"AI\" renders an AI content block (set aiContentBlockId), \"EDITOR\" renders the rich-editor page (set editorPageId)."
              },
              "aiContentBlockId": {
                "type": "string",
                "description": "For a CUSTOM_CONTENT section with contentType=\"AI\": id of the AI content block to render. Write that block's HTML via PUT /content-blocks/{id}/content (it upserts), then reference its id here."
              },
              "editorPageId": {
                "type": "string",
                "description": "For a CUSTOM_CONTENT section with contentType=\"EDITOR\": id of the rich-editor page whose content is rendered inline."
              },
              "source": {
                "type": "string",
                "description": "Internal data source key for built-in sections (e.g. \"banners.items\" for an inline BANNERS section). Usually left as returned by GET."
              }
            },
            "description": "Section customisation. Which keys matter depends on the section `type` (e.g. PREVIEW types read eyebrow/title/subtitle/limit; DONATION_STRIP/NEWSLETTER read eyebrow/title/description/ctaLabel/ctaUrl; CUSTOM_CONTENT reads contentType + aiContentBlockId)."
          }
        },
        "description": "A home or pre-footer section: a `type` + display flags + a `props` bag whose relevant keys depend on the type.",
        "required": [
          "type"
        ]
      },
      "SiteDonationPage": {
        "type": "object",
        "properties": {
          "youtube": {
            "type": "string",
            "nullable": true,
            "description": "YouTube video ID (not the full URL). Empty string or null removes the video."
          },
          "backgroundImage": {
            "type": "string",
            "description": "Page background image. Empty string or null removes it. Image: http(s) URL (re-hosted server-side) or an already-hosted \"md5.ext\" filename.",
            "nullable": true
          },
          "content": {
            "type": "string",
            "nullable": true,
            "description": "Rich HTML page content (the admin rich-editor value). Empty string or null clears it."
          },
          "carousel": {
            "type": "array",
            "items": {
              "type": "string",
              "description": "Image: http(s) URL (re-hosted server-side) or an already-hosted \"md5.ext\" filename."
            },
            "description": "Ordered image filenames or HTTP(S) image URLs (re-hosted). Replaces the entire carousel; [] clears it."
          },
          "presetButtons": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "montant": {
                  "type": "number",
                  "minimum": 1,
                  "description": "Suggested amount in major currency units, minimum 1 (not cents)."
                },
                "text": {
                  "type": "string",
                  "description": "Optional custom button label; empty = formatted amount and currency."
                }
              },
              "required": [
                "montant"
              ],
              "additionalProperties": false
            },
            "description": "Ordered suggested donation amounts. Replaces the entire list; [] restores the theme's default amounts. Each montant is in MAJOR currency units (50 = 50 currency units), minimum 1. An empty text uses the formatted amount and currency. Each language may supply its own complete list, like the admin editor."
          },
          "mainCaisse": {
            "type": "string",
            "nullable": true,
            "description": "ID of a caisse belonging to this organisation, used by the main donation page. Its content/media/presets override this page's values. Empty string or null restores general donations. Manage the caisse itself via /caisses."
          },
          "redirect": {
            "type": "string",
            "nullable": true,
            "description": "Redirect for the main /don route only (not individual caisse pages): a local path starting with / or an absolute HTTP(S) URL. Empty string or null disables the redirect."
          },
          "fr": {
            "type": "object",
            "nullable": true,
            "description": "Translation overlay holding ONLY the translatable fields of this object for one alternate language. The value in the organisation's DEFAULT language stays at the ROOT of the object — it is NOT nested under its own language key. Valid overlay languages are the org's enabled languages minus the default one (WRITING the default language as an overlay is rejected; sending it as null to DELETE a stale overlay is allowed — an org that changed its default language can be left with one). Send this object to create or overwrite that language's translation. Set it to **null** to DELETE the whole overlay for that language: omitting the key means \"leave the existing translation as it is\" on a partial update, so null is the ONLY way to remove one. An empty object ({}) is treated as a deletion too.",
            "properties": {
              "youtube": {
                "type": "string",
                "nullable": true,
                "description": "YouTube video ID (not the full URL). Empty string or null removes the video."
              },
              "backgroundImage": {
                "type": "string",
                "description": "Page background image. Empty string or null removes it. Image: http(s) URL (re-hosted server-side) or an already-hosted \"md5.ext\" filename.",
                "nullable": true
              },
              "content": {
                "type": "string",
                "nullable": true,
                "description": "Rich HTML page content (the admin rich-editor value). Empty string or null clears it."
              },
              "carousel": {
                "type": "array",
                "items": {
                  "type": "string",
                  "description": "Image: http(s) URL (re-hosted server-side) or an already-hosted \"md5.ext\" filename."
                },
                "description": "Ordered image filenames or HTTP(S) image URLs (re-hosted). Replaces the entire carousel; [] clears it."
              },
              "presetButtons": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "montant": {
                      "type": "number",
                      "minimum": 1,
                      "description": "Suggested amount in major currency units, minimum 1 (not cents)."
                    },
                    "text": {
                      "type": "string",
                      "description": "Optional custom button label; empty = formatted amount and currency."
                    }
                  },
                  "required": [
                    "montant"
                  ],
                  "additionalProperties": false
                },
                "description": "Ordered suggested donation amounts. Replaces the entire list; [] restores the theme's default amounts. Each montant is in MAJOR currency units (50 = 50 currency units), minimum 1. An empty text uses the formatted amount and currency. Each language may supply its own complete list, like the admin editor."
              }
            },
            "additionalProperties": false
          },
          "en": {
            "type": "object",
            "nullable": true,
            "description": "Translation overlay holding ONLY the translatable fields of this object for one alternate language. The value in the organisation's DEFAULT language stays at the ROOT of the object — it is NOT nested under its own language key. Valid overlay languages are the org's enabled languages minus the default one (WRITING the default language as an overlay is rejected; sending it as null to DELETE a stale overlay is allowed — an org that changed its default language can be left with one). Send this object to create or overwrite that language's translation. Set it to **null** to DELETE the whole overlay for that language: omitting the key means \"leave the existing translation as it is\" on a partial update, so null is the ONLY way to remove one. An empty object ({}) is treated as a deletion too.",
            "properties": {
              "youtube": {
                "type": "string",
                "nullable": true,
                "description": "YouTube video ID (not the full URL). Empty string or null removes the video."
              },
              "backgroundImage": {
                "type": "string",
                "description": "Page background image. Empty string or null removes it. Image: http(s) URL (re-hosted server-side) or an already-hosted \"md5.ext\" filename.",
                "nullable": true
              },
              "content": {
                "type": "string",
                "nullable": true,
                "description": "Rich HTML page content (the admin rich-editor value). Empty string or null clears it."
              },
              "carousel": {
                "type": "array",
                "items": {
                  "type": "string",
                  "description": "Image: http(s) URL (re-hosted server-side) or an already-hosted \"md5.ext\" filename."
                },
                "description": "Ordered image filenames or HTTP(S) image URLs (re-hosted). Replaces the entire carousel; [] clears it."
              },
              "presetButtons": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "montant": {
                      "type": "number",
                      "minimum": 1,
                      "description": "Suggested amount in major currency units, minimum 1 (not cents)."
                    },
                    "text": {
                      "type": "string",
                      "description": "Optional custom button label; empty = formatted amount and currency."
                    }
                  },
                  "required": [
                    "montant"
                  ],
                  "additionalProperties": false
                },
                "description": "Ordered suggested donation amounts. Replaces the entire list; [] restores the theme's default amounts. Each montant is in MAJOR currency units (50 = 50 currency units), minimum 1. An empty text uses the formatted amount and currency. Each language may supply its own complete list, like the admin editor."
              }
            },
            "additionalProperties": false
          },
          "he": {
            "type": "object",
            "nullable": true,
            "description": "Translation overlay holding ONLY the translatable fields of this object for one alternate language. The value in the organisation's DEFAULT language stays at the ROOT of the object — it is NOT nested under its own language key. Valid overlay languages are the org's enabled languages minus the default one (WRITING the default language as an overlay is rejected; sending it as null to DELETE a stale overlay is allowed — an org that changed its default language can be left with one). Send this object to create or overwrite that language's translation. Set it to **null** to DELETE the whole overlay for that language: omitting the key means \"leave the existing translation as it is\" on a partial update, so null is the ONLY way to remove one. An empty object ({}) is treated as a deletion too.",
            "properties": {
              "youtube": {
                "type": "string",
                "nullable": true,
                "description": "YouTube video ID (not the full URL). Empty string or null removes the video."
              },
              "backgroundImage": {
                "type": "string",
                "description": "Page background image. Empty string or null removes it. Image: http(s) URL (re-hosted server-side) or an already-hosted \"md5.ext\" filename.",
                "nullable": true
              },
              "content": {
                "type": "string",
                "nullable": true,
                "description": "Rich HTML page content (the admin rich-editor value). Empty string or null clears it."
              },
              "carousel": {
                "type": "array",
                "items": {
                  "type": "string",
                  "description": "Image: http(s) URL (re-hosted server-side) or an already-hosted \"md5.ext\" filename."
                },
                "description": "Ordered image filenames or HTTP(S) image URLs (re-hosted). Replaces the entire carousel; [] clears it."
              },
              "presetButtons": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "montant": {
                      "type": "number",
                      "minimum": 1,
                      "description": "Suggested amount in major currency units, minimum 1 (not cents)."
                    },
                    "text": {
                      "type": "string",
                      "description": "Optional custom button label; empty = formatted amount and currency."
                    }
                  },
                  "required": [
                    "montant"
                  ],
                  "additionalProperties": false
                },
                "description": "Ordered suggested donation amounts. Replaces the entire list; [] restores the theme's default amounts. Each montant is in MAJOR currency units (50 = 50 currency units), minimum 1. An empty text uses the formatted amount and currency. Each language may supply its own complete list, like the admin editor."
              }
            },
            "additionalProperties": false
          },
          "it": {
            "type": "object",
            "nullable": true,
            "description": "Translation overlay holding ONLY the translatable fields of this object for one alternate language. The value in the organisation's DEFAULT language stays at the ROOT of the object — it is NOT nested under its own language key. Valid overlay languages are the org's enabled languages minus the default one (WRITING the default language as an overlay is rejected; sending it as null to DELETE a stale overlay is allowed — an org that changed its default language can be left with one). Send this object to create or overwrite that language's translation. Set it to **null** to DELETE the whole overlay for that language: omitting the key means \"leave the existing translation as it is\" on a partial update, so null is the ONLY way to remove one. An empty object ({}) is treated as a deletion too.",
            "properties": {
              "youtube": {
                "type": "string",
                "nullable": true,
                "description": "YouTube video ID (not the full URL). Empty string or null removes the video."
              },
              "backgroundImage": {
                "type": "string",
                "description": "Page background image. Empty string or null removes it. Image: http(s) URL (re-hosted server-side) or an already-hosted \"md5.ext\" filename.",
                "nullable": true
              },
              "content": {
                "type": "string",
                "nullable": true,
                "description": "Rich HTML page content (the admin rich-editor value). Empty string or null clears it."
              },
              "carousel": {
                "type": "array",
                "items": {
                  "type": "string",
                  "description": "Image: http(s) URL (re-hosted server-side) or an already-hosted \"md5.ext\" filename."
                },
                "description": "Ordered image filenames or HTTP(S) image URLs (re-hosted). Replaces the entire carousel; [] clears it."
              },
              "presetButtons": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "montant": {
                      "type": "number",
                      "minimum": 1,
                      "description": "Suggested amount in major currency units, minimum 1 (not cents)."
                    },
                    "text": {
                      "type": "string",
                      "description": "Optional custom button label; empty = formatted amount and currency."
                    }
                  },
                  "required": [
                    "montant"
                  ],
                  "additionalProperties": false
                },
                "description": "Ordered suggested donation amounts. Replaces the entire list; [] restores the theme's default amounts. Each montant is in MAJOR currency units (50 = 50 currency units), minimum 1. An empty text uses the formatted amount and currency. Each language may supply its own complete list, like the admin editor."
              }
            },
            "additionalProperties": false
          },
          "ru": {
            "type": "object",
            "nullable": true,
            "description": "Translation overlay holding ONLY the translatable fields of this object for one alternate language. The value in the organisation's DEFAULT language stays at the ROOT of the object — it is NOT nested under its own language key. Valid overlay languages are the org's enabled languages minus the default one (WRITING the default language as an overlay is rejected; sending it as null to DELETE a stale overlay is allowed — an org that changed its default language can be left with one). Send this object to create or overwrite that language's translation. Set it to **null** to DELETE the whole overlay for that language: omitting the key means \"leave the existing translation as it is\" on a partial update, so null is the ONLY way to remove one. An empty object ({}) is treated as a deletion too.",
            "properties": {
              "youtube": {
                "type": "string",
                "nullable": true,
                "description": "YouTube video ID (not the full URL). Empty string or null removes the video."
              },
              "backgroundImage": {
                "type": "string",
                "description": "Page background image. Empty string or null removes it. Image: http(s) URL (re-hosted server-side) or an already-hosted \"md5.ext\" filename.",
                "nullable": true
              },
              "content": {
                "type": "string",
                "nullable": true,
                "description": "Rich HTML page content (the admin rich-editor value). Empty string or null clears it."
              },
              "carousel": {
                "type": "array",
                "items": {
                  "type": "string",
                  "description": "Image: http(s) URL (re-hosted server-side) or an already-hosted \"md5.ext\" filename."
                },
                "description": "Ordered image filenames or HTTP(S) image URLs (re-hosted). Replaces the entire carousel; [] clears it."
              },
              "presetButtons": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "montant": {
                      "type": "number",
                      "minimum": 1,
                      "description": "Suggested amount in major currency units, minimum 1 (not cents)."
                    },
                    "text": {
                      "type": "string",
                      "description": "Optional custom button label; empty = formatted amount and currency."
                    }
                  },
                  "required": [
                    "montant"
                  ],
                  "additionalProperties": false
                },
                "description": "Ordered suggested donation amounts. Replaces the entire list; [] restores the theme's default amounts. Each montant is in MAJOR currency units (50 = 50 currency units), minimum 1. An empty text uses the formatted amount and currency. Each language may supply its own complete list, like the admin editor."
              }
            },
            "additionalProperties": false
          },
          "pt": {
            "type": "object",
            "nullable": true,
            "description": "Translation overlay holding ONLY the translatable fields of this object for one alternate language. The value in the organisation's DEFAULT language stays at the ROOT of the object — it is NOT nested under its own language key. Valid overlay languages are the org's enabled languages minus the default one (WRITING the default language as an overlay is rejected; sending it as null to DELETE a stale overlay is allowed — an org that changed its default language can be left with one). Send this object to create or overwrite that language's translation. Set it to **null** to DELETE the whole overlay for that language: omitting the key means \"leave the existing translation as it is\" on a partial update, so null is the ONLY way to remove one. An empty object ({}) is treated as a deletion too.",
            "properties": {
              "youtube": {
                "type": "string",
                "nullable": true,
                "description": "YouTube video ID (not the full URL). Empty string or null removes the video."
              },
              "backgroundImage": {
                "type": "string",
                "description": "Page background image. Empty string or null removes it. Image: http(s) URL (re-hosted server-side) or an already-hosted \"md5.ext\" filename.",
                "nullable": true
              },
              "content": {
                "type": "string",
                "nullable": true,
                "description": "Rich HTML page content (the admin rich-editor value). Empty string or null clears it."
              },
              "carousel": {
                "type": "array",
                "items": {
                  "type": "string",
                  "description": "Image: http(s) URL (re-hosted server-side) or an already-hosted \"md5.ext\" filename."
                },
                "description": "Ordered image filenames or HTTP(S) image URLs (re-hosted). Replaces the entire carousel; [] clears it."
              },
              "presetButtons": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "montant": {
                      "type": "number",
                      "minimum": 1,
                      "description": "Suggested amount in major currency units, minimum 1 (not cents)."
                    },
                    "text": {
                      "type": "string",
                      "description": "Optional custom button label; empty = formatted amount and currency."
                    }
                  },
                  "required": [
                    "montant"
                  ],
                  "additionalProperties": false
                },
                "description": "Ordered suggested donation amounts. Replaces the entire list; [] restores the theme's default amounts. Each montant is in MAJOR currency units (50 = 50 currency units), minimum 1. An empty text uses the formatted amount and currency. Each language may supply its own complete list, like the admin editor."
              }
            },
            "additionalProperties": false
          },
          "de": {
            "type": "object",
            "nullable": true,
            "description": "Translation overlay holding ONLY the translatable fields of this object for one alternate language. The value in the organisation's DEFAULT language stays at the ROOT of the object — it is NOT nested under its own language key. Valid overlay languages are the org's enabled languages minus the default one (WRITING the default language as an overlay is rejected; sending it as null to DELETE a stale overlay is allowed — an org that changed its default language can be left with one). Send this object to create or overwrite that language's translation. Set it to **null** to DELETE the whole overlay for that language: omitting the key means \"leave the existing translation as it is\" on a partial update, so null is the ONLY way to remove one. An empty object ({}) is treated as a deletion too.",
            "properties": {
              "youtube": {
                "type": "string",
                "nullable": true,
                "description": "YouTube video ID (not the full URL). Empty string or null removes the video."
              },
              "backgroundImage": {
                "type": "string",
                "description": "Page background image. Empty string or null removes it. Image: http(s) URL (re-hosted server-side) or an already-hosted \"md5.ext\" filename.",
                "nullable": true
              },
              "content": {
                "type": "string",
                "nullable": true,
                "description": "Rich HTML page content (the admin rich-editor value). Empty string or null clears it."
              },
              "carousel": {
                "type": "array",
                "items": {
                  "type": "string",
                  "description": "Image: http(s) URL (re-hosted server-side) or an already-hosted \"md5.ext\" filename."
                },
                "description": "Ordered image filenames or HTTP(S) image URLs (re-hosted). Replaces the entire carousel; [] clears it."
              },
              "presetButtons": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "montant": {
                      "type": "number",
                      "minimum": 1,
                      "description": "Suggested amount in major currency units, minimum 1 (not cents)."
                    },
                    "text": {
                      "type": "string",
                      "description": "Optional custom button label; empty = formatted amount and currency."
                    }
                  },
                  "required": [
                    "montant"
                  ],
                  "additionalProperties": false
                },
                "description": "Ordered suggested donation amounts. Replaces the entire list; [] restores the theme's default amounts. Each montant is in MAJOR currency units (50 = 50 currency units), minimum 1. An empty text uses the formatted amount and currency. Each language may supply its own complete list, like the admin editor."
              }
            },
            "additionalProperties": false
          },
          "es": {
            "type": "object",
            "nullable": true,
            "description": "Translation overlay holding ONLY the translatable fields of this object for one alternate language. The value in the organisation's DEFAULT language stays at the ROOT of the object — it is NOT nested under its own language key. Valid overlay languages are the org's enabled languages minus the default one (WRITING the default language as an overlay is rejected; sending it as null to DELETE a stale overlay is allowed — an org that changed its default language can be left with one). Send this object to create or overwrite that language's translation. Set it to **null** to DELETE the whole overlay for that language: omitting the key means \"leave the existing translation as it is\" on a partial update, so null is the ONLY way to remove one. An empty object ({}) is treated as a deletion too.",
            "properties": {
              "youtube": {
                "type": "string",
                "nullable": true,
                "description": "YouTube video ID (not the full URL). Empty string or null removes the video."
              },
              "backgroundImage": {
                "type": "string",
                "description": "Page background image. Empty string or null removes it. Image: http(s) URL (re-hosted server-side) or an already-hosted \"md5.ext\" filename.",
                "nullable": true
              },
              "content": {
                "type": "string",
                "nullable": true,
                "description": "Rich HTML page content (the admin rich-editor value). Empty string or null clears it."
              },
              "carousel": {
                "type": "array",
                "items": {
                  "type": "string",
                  "description": "Image: http(s) URL (re-hosted server-side) or an already-hosted \"md5.ext\" filename."
                },
                "description": "Ordered image filenames or HTTP(S) image URLs (re-hosted). Replaces the entire carousel; [] clears it."
              },
              "presetButtons": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "montant": {
                      "type": "number",
                      "minimum": 1,
                      "description": "Suggested amount in major currency units, minimum 1 (not cents)."
                    },
                    "text": {
                      "type": "string",
                      "description": "Optional custom button label; empty = formatted amount and currency."
                    }
                  },
                  "required": [
                    "montant"
                  ],
                  "additionalProperties": false
                },
                "description": "Ordered suggested donation amounts. Replaces the entire list; [] restores the theme's default amounts. Each montant is in MAJOR currency units (50 = 50 currency units), minimum 1. An empty text uses the formatted amount and currency. Each language may supply its own complete list, like the admin editor."
              }
            },
            "additionalProperties": false
          },
          "gr": {
            "type": "object",
            "nullable": true,
            "description": "Translation overlay holding ONLY the translatable fields of this object for one alternate language. The value in the organisation's DEFAULT language stays at the ROOT of the object — it is NOT nested under its own language key. Valid overlay languages are the org's enabled languages minus the default one (WRITING the default language as an overlay is rejected; sending it as null to DELETE a stale overlay is allowed — an org that changed its default language can be left with one). Send this object to create or overwrite that language's translation. Set it to **null** to DELETE the whole overlay for that language: omitting the key means \"leave the existing translation as it is\" on a partial update, so null is the ONLY way to remove one. An empty object ({}) is treated as a deletion too.",
            "properties": {
              "youtube": {
                "type": "string",
                "nullable": true,
                "description": "YouTube video ID (not the full URL). Empty string or null removes the video."
              },
              "backgroundImage": {
                "type": "string",
                "description": "Page background image. Empty string or null removes it. Image: http(s) URL (re-hosted server-side) or an already-hosted \"md5.ext\" filename.",
                "nullable": true
              },
              "content": {
                "type": "string",
                "nullable": true,
                "description": "Rich HTML page content (the admin rich-editor value). Empty string or null clears it."
              },
              "carousel": {
                "type": "array",
                "items": {
                  "type": "string",
                  "description": "Image: http(s) URL (re-hosted server-side) or an already-hosted \"md5.ext\" filename."
                },
                "description": "Ordered image filenames or HTTP(S) image URLs (re-hosted). Replaces the entire carousel; [] clears it."
              },
              "presetButtons": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "montant": {
                      "type": "number",
                      "minimum": 1,
                      "description": "Suggested amount in major currency units, minimum 1 (not cents)."
                    },
                    "text": {
                      "type": "string",
                      "description": "Optional custom button label; empty = formatted amount and currency."
                    }
                  },
                  "required": [
                    "montant"
                  ],
                  "additionalProperties": false
                },
                "description": "Ordered suggested donation amounts. Replaces the entire list; [] restores the theme's default amounts. Each montant is in MAJOR currency units (50 = 50 currency units), minimum 1. An empty text uses the formatted amount and currency. Each language may supply its own complete list, like the admin editor."
              }
            },
            "additionalProperties": false
          },
          "ro": {
            "type": "object",
            "nullable": true,
            "description": "Translation overlay holding ONLY the translatable fields of this object for one alternate language. The value in the organisation's DEFAULT language stays at the ROOT of the object — it is NOT nested under its own language key. Valid overlay languages are the org's enabled languages minus the default one (WRITING the default language as an overlay is rejected; sending it as null to DELETE a stale overlay is allowed — an org that changed its default language can be left with one). Send this object to create or overwrite that language's translation. Set it to **null** to DELETE the whole overlay for that language: omitting the key means \"leave the existing translation as it is\" on a partial update, so null is the ONLY way to remove one. An empty object ({}) is treated as a deletion too.",
            "properties": {
              "youtube": {
                "type": "string",
                "nullable": true,
                "description": "YouTube video ID (not the full URL). Empty string or null removes the video."
              },
              "backgroundImage": {
                "type": "string",
                "description": "Page background image. Empty string or null removes it. Image: http(s) URL (re-hosted server-side) or an already-hosted \"md5.ext\" filename.",
                "nullable": true
              },
              "content": {
                "type": "string",
                "nullable": true,
                "description": "Rich HTML page content (the admin rich-editor value). Empty string or null clears it."
              },
              "carousel": {
                "type": "array",
                "items": {
                  "type": "string",
                  "description": "Image: http(s) URL (re-hosted server-side) or an already-hosted \"md5.ext\" filename."
                },
                "description": "Ordered image filenames or HTTP(S) image URLs (re-hosted). Replaces the entire carousel; [] clears it."
              },
              "presetButtons": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "montant": {
                      "type": "number",
                      "minimum": 1,
                      "description": "Suggested amount in major currency units, minimum 1 (not cents)."
                    },
                    "text": {
                      "type": "string",
                      "description": "Optional custom button label; empty = formatted amount and currency."
                    }
                  },
                  "required": [
                    "montant"
                  ],
                  "additionalProperties": false
                },
                "description": "Ordered suggested donation amounts. Replaces the entire list; [] restores the theme's default amounts. Each montant is in MAJOR currency units (50 = 50 currency units), minimum 1. An empty text uses the formatted amount and currency. Each language may supply its own complete list, like the admin editor."
              }
            },
            "additionalProperties": false
          }
        },
        "description": "Main donation page settings (admin « Ma page de don »), shared by the classic, Travel and mobile themes. Partial update: omitted fields and translations are preserved. Media/preset arrays replace the supplied array. Default-language values live at the root; alternate languages can override the five presentation fields, including whole arrays. A linked mainCaisse supplies its own content/media/presets; redirect takes precedence over the main /don page. This does not change organisation-wide payment-provider settings or campaign configuration.",
        "additionalProperties": false
      },
      "SiteSeo": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string",
            "nullable": true,
            "description": "Default page title, also used for Open Graph and Twitter. Theme-specific site suffixes are retained."
          },
          "description": {
            "type": "string",
            "nullable": true,
            "description": "Default meta description and social-sharing description."
          },
          "image": {
            "type": "string",
            "description": "Default social-sharing image. HTTP(S) URLs are re-hosted, including alternate-language images. Image: http(s) URL (re-hosted server-side) or an already-hosted \"md5.ext\" filename.",
            "nullable": true
          },
          "fr": {
            "type": "object",
            "nullable": true,
            "description": "Translation overlay holding ONLY the translatable fields of this object for one alternate language. The value in the organisation's DEFAULT language stays at the ROOT of the object — it is NOT nested under its own language key. Valid overlay languages are the org's enabled languages minus the default one (WRITING the default language as an overlay is rejected; sending it as null to DELETE a stale overlay is allowed — an org that changed its default language can be left with one). Send this object to create or overwrite that language's translation. Set it to **null** to DELETE the whole overlay for that language: omitting the key means \"leave the existing translation as it is\" on a partial update, so null is the ONLY way to remove one. An empty object ({}) is treated as a deletion too.",
            "properties": {
              "title": {
                "type": "string",
                "nullable": true,
                "description": "Default page title, also used for Open Graph and Twitter. Theme-specific site suffixes are retained."
              },
              "description": {
                "type": "string",
                "nullable": true,
                "description": "Default meta description and social-sharing description."
              },
              "image": {
                "type": "string",
                "description": "Default social-sharing image. HTTP(S) URLs are re-hosted, including alternate-language images. Image: http(s) URL (re-hosted server-side) or an already-hosted \"md5.ext\" filename.",
                "nullable": true
              }
            },
            "additionalProperties": false
          },
          "en": {
            "type": "object",
            "nullable": true,
            "description": "Translation overlay holding ONLY the translatable fields of this object for one alternate language. The value in the organisation's DEFAULT language stays at the ROOT of the object — it is NOT nested under its own language key. Valid overlay languages are the org's enabled languages minus the default one (WRITING the default language as an overlay is rejected; sending it as null to DELETE a stale overlay is allowed — an org that changed its default language can be left with one). Send this object to create or overwrite that language's translation. Set it to **null** to DELETE the whole overlay for that language: omitting the key means \"leave the existing translation as it is\" on a partial update, so null is the ONLY way to remove one. An empty object ({}) is treated as a deletion too.",
            "properties": {
              "title": {
                "type": "string",
                "nullable": true,
                "description": "Default page title, also used for Open Graph and Twitter. Theme-specific site suffixes are retained."
              },
              "description": {
                "type": "string",
                "nullable": true,
                "description": "Default meta description and social-sharing description."
              },
              "image": {
                "type": "string",
                "description": "Default social-sharing image. HTTP(S) URLs are re-hosted, including alternate-language images. Image: http(s) URL (re-hosted server-side) or an already-hosted \"md5.ext\" filename.",
                "nullable": true
              }
            },
            "additionalProperties": false
          },
          "he": {
            "type": "object",
            "nullable": true,
            "description": "Translation overlay holding ONLY the translatable fields of this object for one alternate language. The value in the organisation's DEFAULT language stays at the ROOT of the object — it is NOT nested under its own language key. Valid overlay languages are the org's enabled languages minus the default one (WRITING the default language as an overlay is rejected; sending it as null to DELETE a stale overlay is allowed — an org that changed its default language can be left with one). Send this object to create or overwrite that language's translation. Set it to **null** to DELETE the whole overlay for that language: omitting the key means \"leave the existing translation as it is\" on a partial update, so null is the ONLY way to remove one. An empty object ({}) is treated as a deletion too.",
            "properties": {
              "title": {
                "type": "string",
                "nullable": true,
                "description": "Default page title, also used for Open Graph and Twitter. Theme-specific site suffixes are retained."
              },
              "description": {
                "type": "string",
                "nullable": true,
                "description": "Default meta description and social-sharing description."
              },
              "image": {
                "type": "string",
                "description": "Default social-sharing image. HTTP(S) URLs are re-hosted, including alternate-language images. Image: http(s) URL (re-hosted server-side) or an already-hosted \"md5.ext\" filename.",
                "nullable": true
              }
            },
            "additionalProperties": false
          },
          "it": {
            "type": "object",
            "nullable": true,
            "description": "Translation overlay holding ONLY the translatable fields of this object for one alternate language. The value in the organisation's DEFAULT language stays at the ROOT of the object — it is NOT nested under its own language key. Valid overlay languages are the org's enabled languages minus the default one (WRITING the default language as an overlay is rejected; sending it as null to DELETE a stale overlay is allowed — an org that changed its default language can be left with one). Send this object to create or overwrite that language's translation. Set it to **null** to DELETE the whole overlay for that language: omitting the key means \"leave the existing translation as it is\" on a partial update, so null is the ONLY way to remove one. An empty object ({}) is treated as a deletion too.",
            "properties": {
              "title": {
                "type": "string",
                "nullable": true,
                "description": "Default page title, also used for Open Graph and Twitter. Theme-specific site suffixes are retained."
              },
              "description": {
                "type": "string",
                "nullable": true,
                "description": "Default meta description and social-sharing description."
              },
              "image": {
                "type": "string",
                "description": "Default social-sharing image. HTTP(S) URLs are re-hosted, including alternate-language images. Image: http(s) URL (re-hosted server-side) or an already-hosted \"md5.ext\" filename.",
                "nullable": true
              }
            },
            "additionalProperties": false
          },
          "ru": {
            "type": "object",
            "nullable": true,
            "description": "Translation overlay holding ONLY the translatable fields of this object for one alternate language. The value in the organisation's DEFAULT language stays at the ROOT of the object — it is NOT nested under its own language key. Valid overlay languages are the org's enabled languages minus the default one (WRITING the default language as an overlay is rejected; sending it as null to DELETE a stale overlay is allowed — an org that changed its default language can be left with one). Send this object to create or overwrite that language's translation. Set it to **null** to DELETE the whole overlay for that language: omitting the key means \"leave the existing translation as it is\" on a partial update, so null is the ONLY way to remove one. An empty object ({}) is treated as a deletion too.",
            "properties": {
              "title": {
                "type": "string",
                "nullable": true,
                "description": "Default page title, also used for Open Graph and Twitter. Theme-specific site suffixes are retained."
              },
              "description": {
                "type": "string",
                "nullable": true,
                "description": "Default meta description and social-sharing description."
              },
              "image": {
                "type": "string",
                "description": "Default social-sharing image. HTTP(S) URLs are re-hosted, including alternate-language images. Image: http(s) URL (re-hosted server-side) or an already-hosted \"md5.ext\" filename.",
                "nullable": true
              }
            },
            "additionalProperties": false
          },
          "pt": {
            "type": "object",
            "nullable": true,
            "description": "Translation overlay holding ONLY the translatable fields of this object for one alternate language. The value in the organisation's DEFAULT language stays at the ROOT of the object — it is NOT nested under its own language key. Valid overlay languages are the org's enabled languages minus the default one (WRITING the default language as an overlay is rejected; sending it as null to DELETE a stale overlay is allowed — an org that changed its default language can be left with one). Send this object to create or overwrite that language's translation. Set it to **null** to DELETE the whole overlay for that language: omitting the key means \"leave the existing translation as it is\" on a partial update, so null is the ONLY way to remove one. An empty object ({}) is treated as a deletion too.",
            "properties": {
              "title": {
                "type": "string",
                "nullable": true,
                "description": "Default page title, also used for Open Graph and Twitter. Theme-specific site suffixes are retained."
              },
              "description": {
                "type": "string",
                "nullable": true,
                "description": "Default meta description and social-sharing description."
              },
              "image": {
                "type": "string",
                "description": "Default social-sharing image. HTTP(S) URLs are re-hosted, including alternate-language images. Image: http(s) URL (re-hosted server-side) or an already-hosted \"md5.ext\" filename.",
                "nullable": true
              }
            },
            "additionalProperties": false
          },
          "de": {
            "type": "object",
            "nullable": true,
            "description": "Translation overlay holding ONLY the translatable fields of this object for one alternate language. The value in the organisation's DEFAULT language stays at the ROOT of the object — it is NOT nested under its own language key. Valid overlay languages are the org's enabled languages minus the default one (WRITING the default language as an overlay is rejected; sending it as null to DELETE a stale overlay is allowed — an org that changed its default language can be left with one). Send this object to create or overwrite that language's translation. Set it to **null** to DELETE the whole overlay for that language: omitting the key means \"leave the existing translation as it is\" on a partial update, so null is the ONLY way to remove one. An empty object ({}) is treated as a deletion too.",
            "properties": {
              "title": {
                "type": "string",
                "nullable": true,
                "description": "Default page title, also used for Open Graph and Twitter. Theme-specific site suffixes are retained."
              },
              "description": {
                "type": "string",
                "nullable": true,
                "description": "Default meta description and social-sharing description."
              },
              "image": {
                "type": "string",
                "description": "Default social-sharing image. HTTP(S) URLs are re-hosted, including alternate-language images. Image: http(s) URL (re-hosted server-side) or an already-hosted \"md5.ext\" filename.",
                "nullable": true
              }
            },
            "additionalProperties": false
          },
          "es": {
            "type": "object",
            "nullable": true,
            "description": "Translation overlay holding ONLY the translatable fields of this object for one alternate language. The value in the organisation's DEFAULT language stays at the ROOT of the object — it is NOT nested under its own language key. Valid overlay languages are the org's enabled languages minus the default one (WRITING the default language as an overlay is rejected; sending it as null to DELETE a stale overlay is allowed — an org that changed its default language can be left with one). Send this object to create or overwrite that language's translation. Set it to **null** to DELETE the whole overlay for that language: omitting the key means \"leave the existing translation as it is\" on a partial update, so null is the ONLY way to remove one. An empty object ({}) is treated as a deletion too.",
            "properties": {
              "title": {
                "type": "string",
                "nullable": true,
                "description": "Default page title, also used for Open Graph and Twitter. Theme-specific site suffixes are retained."
              },
              "description": {
                "type": "string",
                "nullable": true,
                "description": "Default meta description and social-sharing description."
              },
              "image": {
                "type": "string",
                "description": "Default social-sharing image. HTTP(S) URLs are re-hosted, including alternate-language images. Image: http(s) URL (re-hosted server-side) or an already-hosted \"md5.ext\" filename.",
                "nullable": true
              }
            },
            "additionalProperties": false
          },
          "gr": {
            "type": "object",
            "nullable": true,
            "description": "Translation overlay holding ONLY the translatable fields of this object for one alternate language. The value in the organisation's DEFAULT language stays at the ROOT of the object — it is NOT nested under its own language key. Valid overlay languages are the org's enabled languages minus the default one (WRITING the default language as an overlay is rejected; sending it as null to DELETE a stale overlay is allowed — an org that changed its default language can be left with one). Send this object to create or overwrite that language's translation. Set it to **null** to DELETE the whole overlay for that language: omitting the key means \"leave the existing translation as it is\" on a partial update, so null is the ONLY way to remove one. An empty object ({}) is treated as a deletion too.",
            "properties": {
              "title": {
                "type": "string",
                "nullable": true,
                "description": "Default page title, also used for Open Graph and Twitter. Theme-specific site suffixes are retained."
              },
              "description": {
                "type": "string",
                "nullable": true,
                "description": "Default meta description and social-sharing description."
              },
              "image": {
                "type": "string",
                "description": "Default social-sharing image. HTTP(S) URLs are re-hosted, including alternate-language images. Image: http(s) URL (re-hosted server-side) or an already-hosted \"md5.ext\" filename.",
                "nullable": true
              }
            },
            "additionalProperties": false
          },
          "ro": {
            "type": "object",
            "nullable": true,
            "description": "Translation overlay holding ONLY the translatable fields of this object for one alternate language. The value in the organisation's DEFAULT language stays at the ROOT of the object — it is NOT nested under its own language key. Valid overlay languages are the org's enabled languages minus the default one (WRITING the default language as an overlay is rejected; sending it as null to DELETE a stale overlay is allowed — an org that changed its default language can be left with one). Send this object to create or overwrite that language's translation. Set it to **null** to DELETE the whole overlay for that language: omitting the key means \"leave the existing translation as it is\" on a partial update, so null is the ONLY way to remove one. An empty object ({}) is treated as a deletion too.",
            "properties": {
              "title": {
                "type": "string",
                "nullable": true,
                "description": "Default page title, also used for Open Graph and Twitter. Theme-specific site suffixes are retained."
              },
              "description": {
                "type": "string",
                "nullable": true,
                "description": "Default meta description and social-sharing description."
              },
              "image": {
                "type": "string",
                "description": "Default social-sharing image. HTTP(S) URLs are re-hosted, including alternate-language images. Image: http(s) URL (re-hosted server-side) or an already-hosted \"md5.ext\" filename.",
                "nullable": true
              }
            },
            "additionalProperties": false
          }
        },
        "description": "Default SEO for the homepage and any public CMS page without its own SEO. Each field resolves independently: explicit page SEO, then this site default, then the existing automatically generated value. Applies to classic, Travel, mobile and campaign themes. Default-language values live at the root; enabled alternate languages use partial overlays. Omitted fields/overlays are preserved; null or an empty string clears an individual value (restores fallback). A null/empty language object removes that overlay only.",
        "additionalProperties": false
      },
      "Error": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INVALID_API_KEY"
          }
        }
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "API Key",
        "description": "Format: `ke_live_xxx`"
      },
      "apiKeyHeader": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      }
    },
    "parameters": {
      "VirtualIdParam": {
        "name": "virtualId",
        "in": "query",
        "schema": {
          "type": "string"
        },
        "description": "Façade (virtual site) to target. Omit = the main site. List façades with GET /site/facades."
      }
    }
  }
}
```
