Widgets

Update widgets

Changes the named widgets at once: on or off, name, folder, the e-mails responses go to, reCAPTCHA and the e-mail quality filter. Each item names a widget by id and the fields to set; a field left out is kept. Up to 100 items per call, the page size of List widgets: select with List widgets, then send the ids.

The answer reports every item in the order given: updated, unchanged (already in that state, nothing written) or failed with a reason; one failed item changes nothing of its own and does not stop the others. Items with is_active need the widgets.full right; without it the whole call is refused and nothing is written.

One widget is a list of one. The content (pages, texts, targeting, look) is changed with the widget tools; this operation never touches it or your draft. A move to another folder does not change updated_at.

patch/v1/sites/{site_id}/widgets

Request

  • Base URL
    https://api.getsitecontrol.com
  • Auth
    HTTP bearer

Path parameters

site_idinteger required

Request body

Response

Successful Response

updatedinteger required
unchangedinteger required
failedinteger required

Changes

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