Aller au contenu

Publications

Une publication (post), c’est une publication sur un canal. Publier la même chose sur deux canaux crée deux publications qui partagent un group : c’est ce groupe que le calendrier affiche en une seule carte, et c’est lui que prennent les routes de suppression. Le composeur, l’agent, la CLI et vos propres scripts passent tous par les mêmes routes et la même validation.

POST /posts créer, planifier, publier tout de suite, ou mettre à jour
GET /posts lister une plage de dates
PUT /posts/{id}/status brouillon ⇄ planifiée
GET /posts/{id}/missing éléments récents du fournisseur, pour réparer un releaseId manquant
PUT /posts/{id}/release-id enregistrer l’identifiant du fournisseur
DELETE /posts/{id} supprimer une publication et son groupe
DELETE /posts/group/{group} supprimer un groupe
POST /posts
Champ Type Obligatoire Description
type string Oui draft, schedule, now ou update (voir plus bas)
date string Oui Date de publication, UTC ISO 8601. Ignorée par now, qui publie immédiatement
shortLink boolean Oui Réécrire les liens du texte en liens courts suivis
tags Tag[] Oui [] s’il n’y en a pas
posts PostItem[] Oui Au moins un
order string Non Ordre des publications
inter number Non Répéter tous les n jours (publication récurrente)
creationMethod string Non API (par défaut) ou CLI : l’étiquette de la publication dans les analyses

type décide de la suite :

type Effet
schedule Mise en file, publiée à date
now Publiée immédiatement ; date est remplacée par l’heure actuelle
draft Enregistrée, rien ne se lance. Validée quand même comme une publication planifiée
update Réécrit une publication existante (value[].id la désigne, group son groupe) sans relancer son workflow de publication
Champ Type Obligatoire Description
value string Oui Nom du tag
label string Oui Libellé du tag
Champ Type Obligatoire Description
integration { id } Oui Le canal
value PostContent[] Oui Au moins un. Le premier est la publication ; les suivants partent en commentaires sous elle
settings object Oui Réglages du fournisseur, avec __type qui nomme la plateforme. Validés quel que soit le type, brouillons compris
group string Non Reprendre un identifiant de groupe pour ajouter cette publication à un groupe existant (avec update)
Champ Type Obligatoire Description
content string Oui Le texte. Le HTML est accepté et assaini
image Media[] Oui [] s’il n’y en a pas. Instagram et TikTok en demandent au moins un
id string Non La publication que cet élément met à jour (type: update)
delay number Non Minutes d’attente avant de publier ce commentaire après l’élément précédent
Champ Type Obligatoire Description
id string Oui Identifiant du média, issu d’un téléversement
path string Oui URL publique qui se termine par .png, .jpg, .jpeg, .gif, .webp ou .mp4
alt string Non Texte alternatif
thumbnail string Non La couverture d’une vidéo : l’URL d’un JPEG, idéalement 1080×1920, 8 Mo au plus. Un reel Instagram sort avec elle comme couverture (l’image de la grille du profil). N’importe quelle URL publique, signée comprise : UseNadia en garde une copie à la programmation. Une couverture qu’il ne peut pas télécharger, ou qui n’est pas un JPEG, fait refuser la publication avec un 400 qui la nomme. Voir Instagram

settings.__type doit correspondre à la plateforme du canal. Les plateformes sur lesquelles on publie ont chacune leur page : Instagram (instagram-standalone), TikTok (tiktok), X (x, publication seule, 10 posts avec lien par mois et par compte), LinkedIn (linkedin), YouTube (youtube, une vidéo par publication) et Threads (threads, parties suivantes en réponses enchaînées).

{
"type": "schedule",
"date": "2026-11-03T10:00:00.000Z",
"shortLink": false,
"tags": [],
"posts": [
{
"integration": { "id": "your-instagram-id" },
"value": [
{
"content": "Trois choses que personne ne dit sur Malte.",
"image": [{ "id": "med-123", "path": "https://media.usenadia.com/reel.mp4" }]
}
],
"settings": { "__type": "instagram-standalone", "post_type": "post" }
}
]
}

201 : une entrée par publication créée.

[
{ "postId": "cm4post0001", "integration": "your-instagram-id" }
]
Statut Quand
400 Un champ est mal formé, un identifiant de canal est inconnu, ou la plateforme refuse la publication. Un refus de la plateforme porte provider, name (le canal) et error (ce qu’il faut corriger)
413 Corps de plus de 50 Mo : le média a été intégré au lieu d’être téléversé d’abord
429 La limite horaire

Une publication qui nomme une automatisation dans ses réglages Instagram est aussi vérifiée à la création : une variable manquante, ou des mots-clés envoyés sans automationFlowId, donnent un 400.

GET /posts?startDate=2026-10-01T00:00:00.000Z&endDate=2026-10-31T23:59:59.000Z
Paramètre Obligatoire Description
startDate Oui UTC ISO 8601
endDate Oui UTC ISO 8601
integration Non Seulement ce canal
workspace Non Seulement les canaux de ce workspace (un id renvoyé par GET /workspaces, voir Workspaces et périmètre)
group, customer Non Dépréciés : même effet que workspace

Réponse 200, { "posts": [ … ] }, une ligne par publication (les commentaires ne sont pas listés ; une publication récurrente apparaît une fois par occurrence, chacune avec actualDate) :

Champ Type Description
id string
content string Le texte, en HTML
publishDate string UTC
state string QUEUE, PUBLISHED, ERROR, DRAFT, ou SENT_UNCONFIRMED (une publication TikTok envoyée dans la boîte de réception de l’app, pas encore publiée à la main)
releaseURL string | null URL de la publication en ligne
releaseId string | null Identifiant fournisseur de la publication en ligne ; missing quand le fournisseur n’en a renvoyé aucun
group string Ce que prennent les routes de suppression
intervalInDays number | null Pour une publication récurrente
creationMethod string Sa provenance (API, CLI…)
tags [{ tag }] Chaque tag est l’enregistrement du tag (name, color)
integration object id, providerIdentifier, name, picture

Un téléversement TikTok que TikTok traite encore quand la publication se termine (au bout d’environ 20 minutes) n’est pas une erreur : la publication passe en SENT_UNCONFIRMED avec le publish_id de TikTok comme releaseId, et UseNadia redemande à TikTok toutes les 10 minutes pendant 24 heures. Ensuite, la publication passe en PUBLISHED avec l’identifiant de la vidéo, reste en SENT_UNCONFIRMED avec releaseId: "missing" (un brouillon dans la boîte de réception TikTok, ou aucune réponse en 24 heures), ou passe en ERROR avec la raison donnée par TikTok.

La liste ne contient pas de settings. Les réglages d’une publication ne se lisent pas par l’API aujourd’hui.

PUT /posts/{id}/status
{ "status": "schedule" }

schedule passe l’état à QUEUE et (re)lance le workflow de publication à la date enregistrée ; draft le passe à DRAFT et arrête le workflow. La date ne change pas. Réponse 200 :

{ "id": "cm4post0001", "state": "QUEUE" }

Une publication inconnue donne un 400 (Post not found).

Il arrive qu’une publication parte mais que la plateforme ne renvoie aucun identifiant exploitable : la publication a alors releaseId: "missing", et ses analyses ne peuvent pas être lues. Deux routes la réparent.

GET /posts/{id}/missing

Liste les éléments récents du compte chez le fournisseur, pour reconnaître le bon. Réponse 200 :

[
{ "id": "7321456789012345678", "url": "https://p16-sign.tiktokcdn-us.com/obj/cover.jpeg" }
]

La réponse est [] quand la publication n’est pas dans cet état, ou quand le fournisseur ne sait pas lister ses éléments : aujourd’hui, seul TikTok le sait.

PUT /posts/{id}/release-id
{ "releaseId": "7321456789012345678" }

Enregistre l’identifiant sur la publication. Une publication TikTok en SENT_UNCONFIRMED passe en PUBLISHED, et la carte de contenu liée à son groupe suit. Réponse 200 : la ligne de la publication.

DELETE /posts/{id}
DELETE /posts/group/{group}

Les deux suppriment le groupe entier : la publication désignée, chaque canal avec lequel elle a été publiée, et ses commentaires. Tout workflow de publication en cours est arrêté. Réponse 200 :

{ "id": "cm4post0001" }

Un 404 sur une suppression veut dire que la publication n’existait déjà plus : il s’ignore sans risque.