Update Recommendation Settings

PATCH

https://api.webflow.com/beta/sites/:site_id/aeo/recommendation_settings

PATCH

/beta/sites/:site_id/aeo/recommendation_settings

curl -X PATCH https://api.webflow.com/beta/sites/580e63e98c9a982ac9b8b741/aeo/recommendation_settings \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "ruleConfig": {
    "page_title_required": true
  },
  "recurringAuditsEnabled": false
}'

{
  "ruleConfig": {
    "asset_alt_text_required": true,
    "page_title_required": false,
    "page_title_length_invalid": true,
    "page_title_stale": true,
    "page_description_required": true,
    "page_description_length_invalid": true,
    "page_description_stale": true,
    "page_schema_required": true,
    "page_schema_stale": true,
    "broken_link": true,
    "item_recommendation": true
  },
  "recurringAuditsEnabled": true,
  "lastAuditedOn": "2026-08-01T10:00:00.000Z",
  "createdOn": "2026-08-02T11:00:00.000Z",
  "updatedOn": "2026-08-03T12:00:00.000Z"
}

Partially updates the site’s AEO recommendation settings. Omitted fields are left unchanged. Returns the fully resolved settings document after the update, including createdOn and updatedOn for the persisted document.

AEO recommendations entitlement required

This endpoint requires a workspace with the AEO recommendations entitlement.

Required scope | sites:write

Partially updates the site's AEO recommendation settings. Omitted fields are left unchanged. Returns the fully resolved settings document after the update, including `createdOn` and `updatedOn` for the persisted document. <Warning title="AEO recommendations entitlement required">This endpoint requires a workspace with the AEO recommendations entitlement.</Warning> Required scope | `sites:write`

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

site_idstringRequiredformat: "objectid"

Unique identifier for a Site

Request

Partial update for recommendation settings. Provide at least one of ruleConfig or recurringAuditsEnabled.

ruleConfigobjectOptional

Partial map of recommendation rules to enable or disable. Omitted rules are left unchanged. At least one rule must be present when this object is sent.

recurringAuditsEnabledbooleanOptional

Enable or disable recurring audits.

Response

Updated recommendation settings

ruleConfigobject

Fully resolved per-rule toggles. Every recommendation rule is present.

recurringAuditsEnabledboolean

Whether recurring audits are enabled. Always present on the wire.

lastAuditedOnstringOptionalformat: "date-time"

When the site was last audited.

createdOnstringOptionalformat: "date-time"

When the settings document was created. Omitted when no settings document exists yet (never-configured site).

updatedOnstringOptionalformat: "date-time"

When the settings document was last updated. Omitted when no settings document exists yet (never-configured site).

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error