Parameters

NameTypeRequiredDescription
brandIdstringYesID da brand de ocoya_list_brands.
postGroupIdstringYesID 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:

StatusMeaning
deletedRemovido da rede.
already-goneNão havia nada — já tinha sido eliminado ou nunca foi publicado.
unsupportedEsta rede não tem API de delete. O post continua live.
failedA 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."
    }
  ]
}