Synup
Créer une clé
v1Ressources/Reviews/patchMettre à jour un widget d'avis

Mettre à jour un widget d'avis

Met à jour la configuration ou le design d'un widget (ou le publie, via status).

patch/api/v1/reviews/widgets/{id}
reviews:write
Paramètres de requête
idstringobligatoire
Corps de la requête
namestringfacultatif
minRatingintegerfacultatif
sourcesarray of stringfacultatif
selectionModestringfacultatif
dateWindowstringfacultatif
manualReviewIdsarray of stringfacultatif
countintegerfacultatif
includeInternalbooleanfacultatif
emojiPositiveRatingintegerfacultatif
layoutstringfacultatif
marqueeSpeedintegerfacultatif
themeobjectfacultatif
themeOverridesobjectfacultatif
showFlagsobjectfacultatif
statusstring (draft | published)facultatif
Réponse
dataobjectfacultatif
widgetobjectfacultatif
idstringfacultatif
agencyIdstringfacultatif
locationIdstringfacultatif
clientLocationIdstringfacultatif
namestringfacultatif
minRatingintegerfacultatif
sourcesarray of stringfacultatif
selectionModestringfacultatif
dateWindowstringfacultatif
manualReviewIdsarray of stringfacultatif
countintegerfacultatif
includeInternalbooleanfacultatif
emojiPositiveRatingintegerfacultatif
layoutstringfacultatif
marqueeSpeedintegerfacultatif
themeobjectfacultatif
themeOverridesobjectfacultatif
showFlagsobjectfacultatif
statusstring (draft | published)facultatif
createdAtstringfacultatif
updatedAtstringfacultatif
Erreurs
401Clé API manquante, invalide, expirée ou révoquée.
403La clé n'a pas la permission requise, ou n'est pas autorisée pour ce client/établissement.
404La ressource est introuvable, ou n'appartient pas à votre agence.
429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.
patch/api/v1/reviews/widgets/{id}
Votre clé API
id *
Corps de la requête
{
  "data": {
    "widget": {
      "id": "cm_widget_1",
      "agencyId": "cm_agency_1",
      "locationId": "cm_loc_1",
      "clientLocationId": "cm_loc_1",
      "name": "Homepage reviews (updated)",
      "minRating": 4,
      "sources": [
        "google"
      ],
      "selectionMode": "recent",
      "dateWindow": "all",
      "manualReviewIds": [],
      "count": 10,
      "layout": "grid",
      "theme": "brand",
      "themeOverrides": null,
      "showFlags": null,
      "status": "published",
      "includeInternal": false,
      "emojiPositiveRating": 4,
      "marqueeSpeed": 5,
      "createdAt": "2026-01-15T09:00:00.000Z",
      "updatedAt": "2026-02-01T09:00:00.000Z",
      "createdByUserId": "cm_user_1",
      "createdByType": "user"
    }
  }
}

Guides qui utilisent cette ressource