Parameters

NameTypeRequiredDescription
brandIdstringYesBrand ID da ocoya_list_brands.
postGroupIdstringYesOcoya post group ID.

Request example

{
  "name": "ocoya_delete_post",
  "arguments": {
    "brandId": "cmayvq3hk00017apshay5qezu",
    "postGroupId": "cmajvvb9q0003ja5vh0538j6r"
  }
}

Deleting on the network

Se il post era già stato pubblicato, eliminarlo qui elimina anche la copia pubblicata — su Facebook, Instagram, X, LinkedIn, Pinterest, Threads, Google Business, YouTube, Bluesky, Mastodon, Telegram, Slack, Discord, Dribbble, Tumblr, WordPress, Webflow (l’elemento viene annullato dalla pubblicazione e rimosso dalla sua collection) e Kick. Notion, Airtable e Wix spostano la pagina, la riga o il post del blog nel cestino. Framer rimuove l’elemento dalla sua collection e questo esce dal sito live alla prossima pubblicazione del progetto — l’eliminazione non pubblica mai il progetto. DEV.to non ha un’operazione di delete, quindi un articolo viene riportato a draft; un canale personalizzato (webhook) riceve una richiesta post.deleted, se era stato collegato con una delete URL.

Quattro network non possono proprio farlo e vengono solo riportati: TikTok, Snapchat e Whop non espongono alcun endpoint di delete, e Twitch rifiuta di eliminare i messaggi in chat dello stesso broadcaster.

Un rifiuto da parte del network non fa mai fallire la chiamata — il post viene sempre eliminato in Ocoya — quindi leggi networkDeletes per capire se una copia è ancora online. Un post che è stato sincronizzato da un network invece che pubblicato da Ocoya viene solo rimosso da Ocoya.

Returns

Restituisce l’ID del gruppo di post eliminato, un boolean deleted e networkDeletes: una voce per ogni canale su cui è stato pubblicato, con provider, providerName, socialProfileId, status e, dove c’è qualcosa da dire, message.

status può essere uno tra:

StatusMeaning
deletedRimosso dal network.
already-goneNon c’era nulla — era già stato eliminato o non era mai stato pubblicato.
unsupportedQuesto network non ha una delete API. Il post è ancora online.
failedIl network ha rifiutato. Il post è ancora online; message spiega il motivo.
{
  "postGroupId": "cmajvvb9q0003ja5vh0538j6r",
  "deleted": true,
  "networkDeletes": [
    {
      "provider": "linkedin",
      "providerName": "LinkedIn",
      "socialProfileId": "clh49poxf008x8kov4ncbjty9",
      "status": "deleted"
    },
    {
      "provider": "tiktok",
      "providerName": "TikTok",
      "socialProfileId": "clh49poxf008x8kov4ncbjtz1",
      "status": "unsupported",
      "message": "TikTok has no API for deleting a published post. Delete it in the TikTok app."
    }
  ]
}