Parameters

NameTypeRequiredDescription
brandIdstringYesBrand-ID aus ocoya_list_brands.
postGroupIdstringYesOcoya-Post-Gruppen-ID.

Request example

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

Deleting on the network

Wenn der Post bereits veröffentlicht wurde, löscht du mit diesem Vorgang auch die veröffentlichte Kopie – auf Facebook, Instagram, X, LinkedIn, Pinterest, Threads, Google Business, YouTube, Bluesky, Mastodon, Telegram, Slack, Discord, Dribbble, Tumblr, WordPress, Webflow (das Element wird depubliziert und aus seiner Collection entfernt) und Kick. Notion, Airtable und Wix verschieben die Seite, Zeile oder den Blogpost in ihren Papierkorb. Framer entfernt das Element aus seiner Collection, und es verschwindet von der Live‑Site, sobald das Projekt das nächste Mal veröffentlicht wird – das Löschen selbst veröffentlicht das Projekt nie. DEV.to hat keine Löschfunktion, daher wird ein Artikel wieder in einen Entwurf verwandelt; ein benutzerdefinierter (Webhook-)Kanal erhält eine post.deleted‑Request, wenn er mit einer Delete‑URL verbunden war.

Vier Netzwerke können überhaupt nicht löschen und werden stattdessen gemeldet: TikTok, Snapchat und Whop stellen keinen Delete‑Endpoint zur Verfügung, und Twitch weigert sich, Chatnachrichten des Broadcasters zu löschen.

Wenn ein Netzwerk sich weigert, schlägt der Call nie fehl – der Post wird in Ocoya immer gelöscht – verwende also networkDeletes, um zu erkennen, ob irgendwo noch eine Kopie live ist. Ein Post, der von einem Netzwerk synchronisiert statt von Ocoya veröffentlicht wurde, wird nur aus Ocoya entfernt.

Returns

Gibt die gelöschte Post‑Gruppen‑ID zurück, ein deleted‑Boolean und networkDeletes: einen Eintrag pro veröffentlichtem Kanal mit provider, providerName, socialProfileId, status und – wenn es etwas mitzuteilen gibt – message.

status ist einer von:

StatusMeaning
deletedVom Netzwerk entfernt.
already-goneNichts war mehr da – es wurde schon gelöscht oder nie veröffentlicht.
unsupportedDieses Netzwerk hat keine Delete‑API. Der Post ist weiterhin live.
failedDas Netzwerk hat abgelehnt. Der Post ist weiterhin live; message erklärt warum.
{
  "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."
    }
  ]
}