Parameters

NameTypeRequiredDescription
brandIdstringYesID marki z ocoya_list_brands.
postGroupIdstringYesID grupy postów Ocoya.

Request example

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

Deleting on the network

Jeśli post został już opublikowany, usunięcie go tutaj usuwa też jego opublikowaną kopię — na Facebook, Instagram, X, LinkedIn, Pinterest, Threads, Google Business, YouTube, Bluesky, Mastodon, Telegram, Slack, Discord, Dribbble, Tumblr, WordPress, Webflow (element jest cofnięty z publikacji i usunięty z kolekcji) oraz Kick. Notion, Airtable i Wix przenoszą stronę, wiersz lub wpis na blogu do swojego kosza. Framer usuwa element z kolekcji i znika on ze strony live przy następnym publikowaniu projektu — samo usunięcie nigdy nie powoduje publikacji projektu. DEV.to nie ma usuwania, więc artykuł jest przywracany do wersji roboczej; niestandardowy kanał (webhook) dostaje żądanie post.deleted, jeśli był podłączony z adresem URL do usuwania.

Cztery sieci nie obsługują usuwania w ogóle i są tylko raportowane: TikTok, Snapchat i Whop nie udostępniają endpointu delete, a Twitch odmawia usunięcia własnych wiadomości czatu nadawcy.

Odmowa sieci nigdy nie powoduje błędu wywołania — post jest zawsze usuwany w Ocoya — więc odczytaj networkDeletes, żeby sprawdzić, czy jakaś kopia nadal jest na żywo. Post, który został zsynchronizowany z sieci (zamiast opublikowany przez Ocoya), jest usuwany tylko z Ocoya.

Returns

Zwraca ID usuniętej grupy postów, boolean deleted oraz networkDeletes: jedną pozycję na każdy opublikowany kanał z provider, providerName, socialProfileId, status i, tam gdzie jest coś do przekazania, message.

status może mieć jedną z wartości:

StatusMeaning
deletedUsunięto z sieci.
already-goneNic tam nie było — post został już wcześniej usunięty albo nigdy nie był opublikowany.
unsupportedTa sieć nie ma API do usuwania. Post nadal jest na żywo.
failedSieć odmówiła. Post nadal jest na żywo; message wyjaśnia dlaczego.
{
  "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."
    }
  ]
}