ocoya_delete_post

Parameters

Name	Type	Required	Description
`brandId`	string	Yes	Brand ID from `ocoya_list_brands`.
`postGroupId`	string	Yes	Ocoya 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, Discord, Dribbble, Kick, Tumblr, WordPress, Telegram and Slack. 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:

Status	Meaning
`deleted`	Removed from the network.
`already-gone`	Nothing was there — it had been deleted already, or never published.
`unsupported`	This network has no delete API. The post is still live.
`failed`	The 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."
    }
  ]
}

Get Started

Tools

Parameters

Request example

Deleting on the network

Returns

​Parameters

​Request example

​Deleting on the network

​Returns

Parameters

Request example

Deleting on the network

Returns