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}

PATCH/v1/posts/{id}

Chiave API o access tokenConservato solo in questa scheda e inviato solo ad api.sofia-post.com.id (path)Body della richiesta

Questa richiesta agisce sul tuo account reale.

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

Autorizzazioni

Authorizationstringobbligatorio
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

200application/json

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

402

subscription_required.

403

live_mode_required per un'applicazione di test, oppure manca il permesso posts:write.

404

post_not_found: fuori dalla portata del token.

409

post_not_editable: una rete ha inviato la pubblicazione o la sta inviando.

422application/json

post_refused: una rete, l'attività o Publishing rifiuterebbe la pubblicazione modificata. duplicate_platform per due destinazioni sulla stessa rete.

4XXapplication/json

Qualsiasi altro errore, nella busta di errore.