Parameters

NameTypeRequiredDescription
brandIdstringYesID de brand depuis ocoya_list_brands.
postGroupIdstringYesID du groupe de posts Ocoya.

Request example

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

Deleting on the network

Si le post était déjà publié, le supprimer ici supprime aussi la copie publiée — sur Facebook, Instagram, X, LinkedIn, Pinterest, Threads, Google Business, YouTube, Bluesky, Mastodon, Telegram, Slack, Discord, Dribbble, Tumblr, WordPress, Webflow (l’élément est dépublié et retiré de sa collection) et Kick. Notion, Airtable et Wix déplacent la page, la ligne ou l’article de blog vers leur corbeille. Framer retire l’élément de sa collection, et il quitte le site en ligne lors de la prochaine publication du projet — la suppression ne publie jamais le projet. DEV.to n’a pas de suppression, donc un article est remis en brouillon ; un canal personnalisé (webhook) reçoit une requête post.deleted, s’il était connecté avec une URL de suppression.

Quatre réseaux ne peuvent pas le faire du tout et sont simplement signalés : TikTok, Snapchat et Whop ne proposent aucun endpoint de suppression, et Twitch refuse de supprimer les messages de chat de son propre streamer.

Le refus d’un réseau ne fait jamais échouer l’appel — le post est toujours supprimé dans Ocoya — utilisez donc networkDeletes pour savoir si une copie est encore en ligne. Un post qui a été synchronisé depuis un réseau plutôt que publié par Ocoya est uniquement supprimé dans Ocoya.

Returns

Renvoie l’ID du groupe de posts supprimé, un booléen deleted, et networkDeletes : une entrée par canal publié avec provider, providerName, socialProfileId, status et, lorsqu’il y a quelque chose à signaler, message.

status peut être :

StatusMeaning
deletedSupprimé du réseau.
already-goneIl n’y avait rien — il avait déjà été supprimé ou jamais publié.
unsupportedCe réseau n’a pas d’API de suppression. Le post est toujours en ligne.
failedLe réseau a refusé. Le post est toujours en ligne ; message explique pourquoi.
{
  "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."
    }
  ]
}