Synupv1
Créer une clé
v1Ressources/Idées de post/patchMettre à jour une idée de post

Mettre à jour une idée de post

Met à jour les champs modifiables d'une idée de post. id accepte soit son propre id, soit l'id externe avec lequel elle a été créée.

patch/api/v1/post-ideas/{id}
ideas:write
Paramètres de requête
idstringobligatoire
L'idée de post à mettre à jour — son id ou son externalId.
Corps de la requête
titlestringfacultatif
Le titre de l'idée. Requis à la création.
contentstringfacultatif
Le contenu/corps de légende de l'idée.
imageUrlstringfacultatif
URL d'une image à joindre à l'idée.
imagePromptstringfacultatif
Le prompt utilisé pour générer l'image de l'idée.
typestring (announcement | offer | tip | showcase | story | event)facultatif
Type d'idée.
statusstring (draft | published | archived)facultatif
Statut de l'idée.
platformsarray of stringfacultatif
Plateformes visées par cette idée.
scheduledDatestringfacultatif
Date de publication prévue (YYYY-MM-DD).
scheduledTimestringfacultatif
Heure de publication prévue.
Réponse
dataobjectfacultatif
idstringfacultatif
Identifiant unique de l'idée de post.
locationIdstringfacultatif
ID de l'établissement auquel appartient cette idée, ou null pour une idée de niveau marque.
clientLocationIdstringfacultatif
ID de l'enregistrement d'établissement résolu, ou null.
clientIdstringfacultatif
ID du client auquel appartient cette idée (idées de niveau marque), ou null.
brandNamestringfacultatif
Nom d'affichage du profil de marque, pour les idées de niveau marque, ou null.
titlestringfacultatif
Le titre de l'idée.
contentstringfacultatif
Le contenu/corps de légende de l'idée.
imageUrlstringfacultatif
URL de l'image de l'idée, ou null.
imagePromptstringfacultatif
Le prompt utilisé pour générer l'image de l'idée, ou null.
typestring (announcement | offer | tip | showcase | story | event)facultatif
Type d'idée : announcement, offer, tip, showcase, story ou event.
statusstring (draft | published | archived)facultatif
Statut de l'idée : draft, published ou archived.
bucketstring (idea | holiday | calendar | series)facultatif
Dans quelle catégorie de grille se trouve l'idée : idea, holiday, calendar ou series.
platformsarray of stringfacultatif
Plateformes visées par cette idée.
seriesIdstringfacultatif
ID de la série de contenu à laquelle appartient cette idée, ou null.
scheduledDatestringfacultatif
Date de publication prévue (YYYY-MM-DD), ou null.
scheduledTimestringfacultatif
Heure de publication prévue, ou null.
externalIdstringfacultatif
Id stable avec lequel cette idée a été créée, si elle provient d'une source externe.
sourcestring (os | agent)facultatif
D'où provient l'idée : os (créée dans Synup) ou agent (envoyée par un agent IA).
reviewStatusstring (pending | approved | rejected)facultatif
Portail de validation : null (aucun portail), pending, approved ou rejected.
generationJobIdstringfacultatif
ID du job de génération IA qui a produit cette idée, le cas échéant, ou null.
isUserGeneratedbooleanfacultatif
Si une personne (plutôt qu'un agent) a créé cette idée.
archivedbooleanfacultatif
Si cette idée a été archivée.
archivedAtstringfacultatif
Date d'archivage de cette idée, au format horodatage ISO 8601, ou null.
createdAtstringfacultatif
Date de création de cette idée, au format horodatage ISO 8601.
updatedAtstringfacultatif
Date de dernière mise à jour de cette idée, au format horodatage ISO 8601.
locationNamestringfacultatif
Nom d'affichage de l'établissement de l'idée. Présent uniquement lors de la liste des idées au niveau établissement d'un client.
Erreurs
400Il manque un paramètre requis à la requête, ou elle est invalide.
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/post-ideas/{id}
Votre clé API
id *
Corps de la requête
{
  "data": {
    "id": "cm_idea_abc123",
    "agencyId": "cm_agency_1",
    "locationId": "cm_loc_1",
    "clientLocationId": "cm_loc_1",
    "clientId": null,
    "brandName": null,
    "agentMeta": null,
    "title": "Spotlight our new patient special (updated)",
    "content": "Book this month and get 25% off your first cleaning!",
    "imagePrompt": null,
    "imageUrl": null,
    "type": "announcement",
    "status": "draft",
    "bucket": "idea",
    "platforms": [
      "google",
      "facebook"
    ],
    "seriesId": null,
    "scheduledDate": null,
    "scheduledTime": null,
    "observanceName": null,
    "observanceDate": null,
    "generationBatchId": null,
    "generationJobId": null,
    "isUserGenerated": true,
    "source": "os",
    "externalId": "cm_idea_abc123",
    "reviewStatus": null,
    "archived": false,
    "archivedAt": null,
    "createdAt": "2026-01-20T09:00:00.000Z",
    "updatedAt": "2026-01-20T09:05:00.000Z"
  }
}