# Update Social Proof Config

PUT /api/v2/projects/{projectId}/social-proof

Replaces the widget's enabled flag, feed window, theme, and display rules. Templates are saved separately.

## Request

- projectId: string, path, required — ID of the project whose widget to update.
- config: object, required — Enabled flag, feed window, theme, and display rules.
  - display: object, required
    - displayDurationSeconds: integer, default 4 — Seconds each notification stays visible.
    - hideOnDesktop: boolean, default false — Skip the widget on desktop browsers.
    - hideOnMobile: boolean, default false — Skip the widget on mobile browsers.
    - initialDelaySeconds: integer, default 5 — Seconds after page load before the first notification.
    - intervalSeconds: integer, default 15 — Seconds between one notification hiding and the next showing.
    - maxPerPage: integer, default 5 — Maximum notifications per page load.
    - maxPerSession: integer, default 100 — Maximum notifications per visitor session.
    - pageRules: object[] — Ordered page rules. Earlier rules win. Each rule decides whether notifications render on a matching page and how they behave.
  - theme: object, required
    - desktop: object — Desktop look. Independent of mobile.
    - hoverAnimation: none | shift-right | shift-up, default none — Pointer-hover animation. Desktop only.
    - mobile: object — Mobile look. Independent of desktop, and it starts from the same defaults.
    - mobilePosition: top | bottom, default bottom — Edge the notification stack anchors to on mobile. Centered, top or bottom.
    - position: bottom-left | bottom-center | bottom-right | top-left | top-center | top-right, default bottom-left — Corner the notification stack anchors to on desktop.
    - showTimestamp: boolean, de
…

## Response

- 200: Successful response
  - display: object, required
    - displayDurationSeconds: integer, required, default 4 — Seconds each notification stays visible.
    - hideOnDesktop: boolean, required, default false — Skip the widget on desktop browsers.
    - hideOnMobile: boolean, required, default false — Skip the widget on mobile browsers.
    - initialDelaySeconds: integer, required, default 5 — Seconds after page load before the first notification.
    - intervalSeconds: integer, required, default 15 — Seconds between one notification hiding and the next showing.
    - maxPerPage: integer, required, default 5 — Maximum notifications per page load.
    - maxPerSession: integer, required, default 100 — Maximum notifications per visitor session.
    - pageRules: object[], required — Ordered page rules. Earlier rules win. Each rule decides whether notifications render on a matching page and how they behave.
  - enabled: boolean, required, default false — Whether the visitor-facing widget loads.
  - maxEventAgeHours: integer, required, default 24 — How many hours of events the feed includes, from 1 hour to 30 days.
  - templates: object[], required — Notification templates for this project.
    - enabled: boolean, required, default true — When false, this template is not served to visitors. Defaults to true.
    - eventRules: object[], required — If/then rules applied when the feed is built. They can block an event or rewrite a field.
    - id: string, required — ID of the template.
    - linkToEvent: boolean, required, default false — When true, a click opens linkUrl or the 
…
