Parameters
| Name | Type | Required | Description |
|---|---|---|---|
brandId | string | Yes | Brand ID da ocoya_list_brands. |
postGroupId | string | Yes | Ocoya 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:
| Status | Meaning |
|---|---|
deleted | Rimosso dal network. |
already-gone | Non c’era nulla — era già stato eliminato o non era mai stato pubblicato. |
unsupported | Questo network non ha una delete API. Il post è ancora online. |
failed | Il 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."
}
]
}