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}

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"}'

{
  "id": "string",
  "status": "published",
  "establishmentId": "string",
  "scheduledAt": "2026-11-02T10:00:00.000Z",
  "createdAt": "2026-11-02T10:00:00.000Z",
  "targets": [
    {
      "platform": "instagram",
      "accountId": "string",
      "state": "published",
      "permalink": "https://www.instagram.com/p/C1"
    }
  ]
}

Modifier une publication

curl --request PATCH \
  --url 'https://api.sofia-post.com/api/v1/posts/<id>' \
  --header "Authorization: Bearer $SOFIA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "scheduledAt": "2026-11-02T10:00:00.000Z"
}'

{
  "id": "string",
  "status": "published",
  "establishmentId": "string",
  "scheduledAt": "2026-11-02T10:00:00.000Z",
  "createdAt": "2026-11-02T10:00:00.000Z",
  "targets": [
    {
      "platform": "instagram",
      "accountId": "string",
      "state": "published",
      "permalink": "https://www.instagram.com/p/C1"
    }
  ]
}

PATCH /v1/posts/{id} réécrit les cibles, déplace scheduledAt ou change status : draft retire l’horaire et garde le contenu, scheduled la reprogramme. Une fois qu’un réseau a envoyé la publication, la réponse est 409 post_not_editable.

curl -X PATCH https://api.sofia-post.com/api/v1/posts/$POST_ID \
  -H "Authorization: Bearer $SOFIA_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"status":"scheduled","scheduledAt":"2026-11-20T09:00:00Z"}'

Autorisations

Authorizationstringheaderrequis
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

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

Cette page vous a-t-elle aidé ?