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, 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:
| 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."
}
]
}