Pubblicazioni

Modificare una pubblicazione

Finché nessuna rete ha iniziato l'invio, sostituisce targets, imposta scheduledAt o passa tra draft e scheduled. I campi omessi restano invariati.

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

Modificare una pubblicazione

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} riscrive le destinazioni, sposta scheduledAt o cambia status: draft toglie l’orario e conserva il contenuto, scheduled lo riprogramma. Una volta che una rete ha inviato il post, la risposta è 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"}'

Autorizzazioni

Authorizationstringheaderobbligatorio
La tua chiave personale o il token di accesso OAuth, inviato come Bearer <token>.

Parametri di percorso

idstringobbligatorio
Identificatore della pubblicazione.

Body

application/json

targetsobject[]
Tutte le destinazioni, riscritte (testo, media, formato, account); assente: mantenute
Mostra gli attributi figli
- platformstringobbligatorio
  Rete di destinazione
  Valori ammessi: instagramfacebookxlinkedintiktok
- textstringobbligatorio
  Didascalia pubblicata su questa rete
- mediaobject[]
  Media allegati
  Mostra gli attributi figli
  - idstring
    Identificatore di un media della mediateca dell'attività (altrimenti url e type)
  - urlstring
    Indirizzo pubblico del media (https in live); senza identificatore
  - typestring
    Tipo del media dato per indirizzo
    Valori ammessi: imagevideo
- formatstring
  Formato (post, reel, story, carousel...); per default, quello che la rete offrirebbe
- accountIdstring
  Live: l'account collegato che pubblica, quando l'attività ne ha più di uno su questa rete (GET /v1/establishments/:id/accounts)
scheduledAtstring<date-time>
Nuova data, nel futuro: la pubblicazione è programmata a questa data
statusstring
draft: torna in bozza (mantiene il contenuto, perde l'orario); scheduled: programma a scheduledAt, o all'orario che aveva
Valori ammessi: draftscheduled

Risposta

La pubblicazione dopo la modifica.

idstringobbligatorio
Identificatore della pubblicazione
statusstringobbligatorio
Su tutte le reti; partial: pubblicata su una, fallita su un'altra
Valori ammessi: draftscheduledpublishingpublishedsent_to_inboxfailedpartial
establishmentIdstringobbligatorio
Attività della pubblicazione
createdAtstring<date-time>obbligatorio
Quando la pubblicazione è stata creata
targetsobject[]obbligatorio
Una voce per rete e account: due account sulla stessa rete, due voci
Mostra gli attributi figli
- platformstringobbligatorio
  Rete della destinazione
- accountIdstringobbligatorio
  L'account che pubblica (GET /v1/establishments/:id/accounts)
- statestringobbligatorio
  Stato della destinazione sulla sua rete
  Valori ammessi: draftscheduledpublishingpublishedsent_to_inboxfailed
- publishedAtstring<date-time>
  Quando la destinazione è stata pubblicata
- permalinkstring
  Link alla pubblicazione sulla rete
- errorstring
  Perché la rete ha rifiutato
scheduledAtstring<date-time>
Quando la pubblicazione è programmata

Questa pagina ti è stata utile?