Parameters

NameTypeRequiredDescription
brandIdstringYesBrand ID iš ocoya_list_brands.
postGroupIdstringYesOcoya įrašo grupės ID.

Request example

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

Deleting on the network

Jei įrašas jau buvo publikuotas, jį ištrynus čia, ištrinamas ir paskelbtas jo variantas – iš Facebook, Instagram, X, LinkedIn, Pinterest, Threads, Google Business, YouTube, Bluesky, Mastodon, Telegram, Slack, Discord, Dribbble, Tumblr, WordPress, Webflow (elementas „unpublishinamas“ ir pašalinamas iš jo kolekcijos) bei Kick. Notion, Airtable ir Wix puslapį, eilutę arba tinklaraščio įrašą perkelia į savo šiukšlinę. Framer pašalina elementą iš jo kolekcijos ir jis dingsta iš gyvos svetainės tada, kai projektas kitą kartą publikuojamas – trynimas niekada nepublikuoja projekto. DEV.to neturi trynimo funkcijos, todėl straipsnis grąžinamas į juodraščio būseną; pasirinktinam (webhook) kanalui išsiunčiama post.deleted užklausa, jei jis buvo prijungtas su trynimo URL.

Keturi tinklai to daryti apskritai negali, ir tai grąžinama ataskaitoje: TikTok, Snapchat ir Whop nepublikuoja jokio delete endpoint, o Twitch atsisako trinti paties transliuotojo pokalbių žinutes.

Tinklo atsisakymas niekada nesukelia klaidos pačioje užklausoje – įrašas visada ištrinamas Ocoya viduje – todėl pažiūrėkite į networkDeletes, kad sužinotumėte, ar kopija vis dar yra gyva. Įrašas, kuris buvo sinchronizuotas iš tinklo, o ne publikuotas per Ocoya, yra tik pašalinamas iš Ocoya.

Returns

Grąžinamas ištrintos įrašo grupės ID, deleted loginė reikšmė ir networkDeletes: po vieną įrašą kiekvienam kanalui, kuriame buvo publikuota, su provider, providerName, socialProfileId, status ir, kai yra ką pasakyti, message.

status gali būti vienas iš:

StatusMeaning
deletedPašalinta iš tinklo.
already-goneTen nieko nebuvo – tai jau buvo ištrinta arba niekada nebuvo publikuota.
unsupportedŠis tinklas neturi trynimo API. Įrašas vis dar gyvas.
failedTinklas atsisakė. Įrašas vis dar gyvas; message paaiškina, kodėl.
{
  "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."
    }
  ]
}