PublicationsModifier une publication
Retour à Sofia

Publications

Modifier une publication

Avant l’envoi sur un réseau, remplace les targets, fixe scheduledAt ou passe la publication de draft à scheduled et inversement. Champs omis conservés.

PATCHhttps://api.sofia-post.com/api/v1/posts/{id}
PATCH/v1/posts/{id}

Cette requête agit sur votre vrai compte.

curl -X PATCH 'https://api.sofia-post.com/api/v1/posts/{id}' \
  -H "Authorization: Bearer $SOFIA_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"scheduledAt":"2026-11-02T10:00:00.000Z"}'

Autorisations

  • Authorizationstringrequis

    Votre clé personnelle ou jeton d’accès OAuth, envoyé sous la forme Bearer <token>.

Paramètres de chemin

  • idstringrequis

    Identifiant de la publication.

Corps

application/json

  • targetsobject[]

    Toutes les cibles, réécrites (texte, médias, format, compte) ; absent : conservées

    Afficher les attributs enfants
    • platformstringrequis

      Réseau visé

      Valeurs autorisées : instagramfacebookxlinkedintiktok

    • textstringrequis

      Légende publiée sur ce réseau

    • mediaobject[]

      Médias joints

      Afficher les attributs enfants
      • idstring

        Identifiant d’un média de la médiathèque de l’établissement (sinon url et type)

      • urlstring

        Adresse publique du média (https en live) ; sans identifiant

      • typestring

        Type du média donné par adresse

        Valeurs autorisées : imagevideo

    • formatstring

      Format (post, reel, story, carousel...) ; par défaut, celui que le réseau servirait

    • accountIdstring

      En live : le compte connecté qui publie, quand l’établissement en a plusieurs sur ce réseau (GET /v1/establishments/:id/accounts)

  • scheduledAtstring<date-time>

    Nouvelle date, dans le futur : la publication est programmée à cette date

  • statusstring

    draft : retour en brouillon (garde le contenu, perd l’horaire) ; scheduled : programme à scheduledAt, ou à l’heure qu’elle avait

    Valeurs autorisées : draftscheduled

Réponse

200application/json

La publication après modification.

  • idstringrequis

    Identifiant de la publication

  • statusstringrequis

    Sur l’ensemble des réseaux ; partial : publiée sur l’un, échouée sur l’autre

    Valeurs autorisées : draftscheduledpublishingpublishedsent_to_inboxfailedpartial

  • establishmentIdstringrequis

    Établissement de la publication

  • createdAtstring<date-time>requis

    Moment où la publication a été créée

  • targetsobject[]requis

    Une entrée par réseau et par compte : deux comptes sur un même réseau, deux entrées

    Afficher les attributs enfants
    • platformstringrequis

      Réseau de la cible

    • accountIdstringrequis

      Le compte qui publie (GET /v1/establishments/:id/accounts)

    • statestringrequis

      État de la cible sur son réseau

      Valeurs autorisées : draftscheduledpublishingpublishedsent_to_inboxfailed

    • publishedAtstring<date-time>

      Moment où la cible a été publiée

    • permalinkstring

      Lien vers la publication sur le réseau

    • errorstring

      Pourquoi le réseau a refusé

  • scheduledAtstring<date-time>

    Moment où la publication doit paraître

402

subscription_required.

403

live_mode_required pour une application de test, ou la permission posts:write manque.

404

post_not_found : hors de portée du jeton.

409

post_not_editable : un réseau a envoyé la publication ou est en train de l’envoyer.

422application/json

post_refused : un réseau, l’établissement ou Publishing refuserait la publication modifiée. duplicate_platform pour deux cibles sur un même réseau.

4XXapplication/json

Toute autre erreur, dans l’enveloppe d’erreur.