Flux RSS

Permission : posts.read. Voir Rôles et permissions.

Lister et lire les flux et leurs éléments demande posts.read. Créer, prévisualiser, modifier, mettre en pause, reprendre, vérifier et supprimer demandent posts.draft, plus la permission qu'exige le mode de publication du flux : posts.schedule pour SCHEDULE, posts.publish pour PUBLISH et ai.generate pour les légendes IA. Un flux configuré par un autre membre demande aussi posts.others pour le modifier, le mettre en pause, le reprendre, le vérifier ou le supprimer.

Un flux est vérifié selon un calendrier, et chaque élément apparu après son ajout devient une publication sur les comptes de targets. Chaque publication passe par les mêmes contrôles que Créer une publication. Un flux publie au nom du membre qui l'a enregistré en dernier : créer, modifier ou reprendre un flux fait du membre de la clé son propriétaire.

POST /api/v1/rss-feeds

Récupère le flux et enregistre chaque élément qui s'y trouve déjà, pour que seuls les éléments apparus ensuite soient publiés. Un espace de travail peut contenir jusqu'à 20 flux.

Les cibles possibles sont FACEBOOK, INSTAGRAM, THREADS, TWITTER, BLUESKY, LINKEDIN, MASTODON, TELEGRAM et GOOGLE_BUSINESS.

Exemple de requête :

{
  "url": "https://blog.example.com/feed.xml",
  "targets": [
    { "platform": "LINKEDIN", "connectionId": "conn_li_001" },
    { "platform": "FACEBOOK", "connectionId": "conn_fb_001", "pageId": "123456789012345" }
  ],
  "postMode": "SCHEDULE",
  "publishDelayMinutes": 30,
  "contentMode": "TEMPLATE",
  "template": "Nouveau sur le blog : {title}\n\n{link}",
  "excludeKeywords": ["sponsored"]
}

Renvoie 201 avec le flux :

{
  "id": "rss_01j9x",
  "userId": "user_123",
  "accountGroupId": "ag_01j9x",
  "name": "Example Blog",
  "url": "https://blog.example.com/feed.xml",
  "siteUrl": "https://blog.example.com",
  "status": "ACTIVE",
  "postMode": "SCHEDULE",
  "publishDelayMinutes": 30,
  "contentMode": "TEMPLATE",
  "template": "Nouveau sur le blog : {title}\n\n{link}",
  "includeImage": true,
  "twitterKeepLinks": false,
  "includeKeywords": [],
  "excludeKeywords": ["sponsored"],
  "maxPostsPerCheck": 3,
  "checkIntervalMinutes": 60,
  "targets": [
    { "platform": "LINKEDIN", "connectionId": "conn_li_001", "displayName": "Example Inc." },
    { "platform": "FACEBOOK", "connectionId": "conn_fb_001", "pageId": "123456789012345", "displayName": "Example" }
  ],
  "nextCheckAt": "2026-11-08T15:00:00.000Z",
  "createdAt": "2026-11-08T14:00:00.000Z",
  "updatedAt": "2026-11-08T14:00:00.000Z"
}

Une URL qui n'est pas un flux RSS ou Atom, un flux déjà connecté, une plateforme cible non prise en charge, un publishDelayMinutes manquant ou la limite de 20 flux renvoie 400. Un flux injoignable renvoie 503. Une clé sans la permission qu'exigent le mode de publication ou les légendes IA renvoie 403.

Champs d'un flux

Les autres champs reprennent les réglages ci-dessus.

Corrigez la cause, puis reprenez le flux.

POST /api/v1/rss-feeds/preview

Prend url et un template facultatif, récupère le flux sans rien enregistrer et renvoie url, title, siteUrl et ses 5 items les plus récents, chacun avec title, link, summary, publishedAt, imageUrl et text, l'élément rendu avec le modèle.

GET /api/v1/rss-feeds/:id/items

Liste les éléments que le flux a vus, du plus récent au plus ancien, sans ceux qui s'y trouvaient déjà lors de son ajout. limit accepte 1 à 100, 20 par défaut. Renvoie { "items": [...] }, chacun avec id, title, link, publishedAt, createdAt, status, postId et error.

Modifier, mettre en pause, reprendre, vérifier et supprimer

PATCH accepte les mêmes champs que la création, sauf url et postLatestItem, et ne modifie que ceux que vous envoyez. La pause, la reprise, la vérification et la suppression ne prennent pas de corps. Toutes sauf la suppression renvoient le flux ; la suppression renvoie { "deleted": true }. Un id qui n'existe pas ou qui appartient à un autre espace de travail renvoie 404.