Parameters
| Name | Type | Required | Description |
|---|---|---|---|
brandId | string | Yes | Brand-ID aus ocoya_list_brands. |
postGroupId | string | Yes | Ocoya-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:
| Status | Meaning |
|---|---|
deleted | Vom Netzwerk entfernt. |
already-gone | Nichts war mehr da – es wurde schon gelöscht oder nie veröffentlicht. |
unsupported | Dieses Netzwerk hat keine Delete‑API. Der Post ist weiterhin live. |
failed | Das 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."
}
]
}