Parameters
| Name | Type | Required | Description |
|---|---|---|---|
brandId | string | Yes | ID da brand de ocoya_list_brands. |
postGroupId | string | Yes | ID do grupo de posts da Ocoya. |
Request example
{
"name": "ocoya_delete_post",
"arguments": {
"brandId": "cmayvq3hk00017apshay5qezu",
"postGroupId": "cmajvvb9q0003ja5vh0538j6r"
}
}Deleting on the network
Se o post já tiver sido publicado, ao eliminá-lo aqui elimina também a cópia
publicada — em Facebook, Instagram, X, LinkedIn, Pinterest, Threads, Google Business,
YouTube, Bluesky, Mastodon, Telegram, Slack, Discord, Dribbble, Tumblr,
WordPress, Webflow (o item é despublicado e removido da respetiva coleção)
e Kick. Notion, Airtable e Wix movem a página, linha ou artigo de blog para o lixo. Framer
remove o item da coleção, e ele sai do site live da próxima vez que o projeto
for publicado — eliminar nunca publica o projeto. DEV.to não tem delete, por isso um artigo é revertido para rascunho; um canal personalizado (webhook) recebe
um pedido post.deleted, se tiver sido ligado com um URL de delete.
Quatro redes não conseguem fazê-lo de todo e são apenas reportadas: TikTok, Snapchat e Whop não disponibilizam nenhum endpoint de delete, e a Twitch recusa-se a eliminar as mensagens de chat do próprio broadcaster.
Uma recusa da rede nunca faz a chamada falhar — o post é sempre eliminado na Ocoya —
por isso leia networkDeletes para saber se ainda existe uma cópia live. Um post que foi
sincronizado a partir de uma rede em vez de publicado pela Ocoya é apenas removido da Ocoya.
Returns
Devolve o ID do grupo de posts eliminado, um booleano deleted e networkDeletes:
uma entrada por canal publicado, com provider, providerName,
socialProfileId, status e, quando houver algo a indicar, message.
status é um de:
| Status | Meaning |
|---|---|
deleted | Removido da rede. |
already-gone | Não havia nada — já tinha sido eliminado ou nunca foi publicado. |
unsupported | Esta rede não tem API de delete. O post continua live. |
failed | A rede recusou. O post continua live; message explica porquê. |
{
"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."
}
]
}