Parameters

NameTypeRequiredDescription
brandIdstringYesBrand ID from ocoya_list_brands.
postGroupIdstringYesOcoya post group ID.

Request example

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

Deleting on the network

If the post was already published, deleting it here deletes the published copy too — on Facebook, Instagram, X, LinkedIn, Pinterest, Threads, Google Business, YouTube, Bluesky, Mastodon, Telegram, Slack, Discord, Dribbble, Tumblr, WordPress, Webflow (the item is unpublished and removed from its collection) and Kick. Notion, Airtable and Wix move the page, row or blog post to their trash. Framer removes the item from its collection, and it leaves the live site the next time the project is published — deleting never publishes the project. DEV.to has no delete, so an article is reverted to a draft; a custom (webhook) channel is sent a post.deleted request, if it was connected with a delete URL.

Four networks cannot do it at all and are reported instead: TikTok, Snapchat and Whop publish no delete endpoint, and Twitch refuses to delete the broadcaster’s own chat messages.

A network refusing never fails the call — the post is always deleted in Ocoya — so read networkDeletes to tell whether a copy is still live. A post that was synced from a network rather than published by Ocoya is only removed from Ocoya.

Returns

Returns the deleted post group ID, a deleted boolean, and networkDeletes: one entry per published channel with provider, providerName, socialProfileId, status and, where there is something to say, message.

status is one of:

StatusMeaning
deletedRemoved from the network.
already-goneNothing was there — it had been deleted already, or never published.
unsupportedThis network has no delete API. The post is still live.
failedThe network refused. The post is still live; message says why.
{
  "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."
    }
  ]
}