Synupv1
Créer une clé
v1Ressources/Idées de post/postCréer une idée de post

Créer une idée de post

Crée (ou, pour un externalId déjà utilisé, met à jour) une idée de post en brouillon, en attente de validation ou prête à être publiée.

post/api/v1/post-ideas
ideas:write
Corps de la requête
locationIdstringfacultatif
L'établissement concerné par cette idée, ou à omettre pour une idée de niveau marque.
clientIdstringfacultatif
Le client concerné par cette idée (idées de niveau marque).
titlestringobligatoire
Le titre de l'idée. Requis à la création.
contentstringfacultatif
Le contenu/corps de légende de l'idée.
externalIdstringobligatoire
Un id stable que vous contrôlez — répéter une création avec le même externalId met à jour l'idée existante au lieu de la dupliquer. Requis à la création.
originstring (channel | routine | os_button)obligatoire
D'où provient cette idée : channel, routine ou os_button. Requis à la création.
typestring (announcement | offer | tip | showcase | story | event)facultatif
Type d'idée.
bucketstring (idea | holiday | calendar | series)facultatif
Dans quelle catégorie de grille se trouve l'idée.
platformsarray of stringfacultatif
Plateformes visées par cette 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.
seriesIdstringfacultatif
ID de la série de contenu à laquelle rattacher cette idée.
scheduledDatestringfacultatif
Date de publication prévue (YYYY-MM-DD).
scheduledTimestringfacultatif
Heure de publication prévue.
generationJobIdstringfacultatif
ID du job de génération IA qui a produit cette idée, le cas échéant.
Réponse
dataobjectfacultatif
idstringfacultatif
Identifiant unique de l'idée de post.
createdbooleanfacultatif
Si cet appel a créé une nouvelle idée (false si une idée avec cet externalId existait déjà et a été mise à jour à la place).
reviewStatusstringfacultatif
Portail de validation : null (aucun portail), pending, approved ou rejected.
statusstringfacultatif
Statut de l'idée : draft, published ou archived.
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.
422Il manque un paramètre requis à la requête, ou elle est invalide.
429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.
post/api/v1/post-ideas
Votre clé API
Corps de la requête*
{
  "data": {
    "id": "cm_idea_abc123",
    "created": true,
    "reviewStatus": null,
    "status": "draft"
  }
}