Parameters
| Name | Type | Required | Description |
|---|---|---|---|
brandId | string | Yes | ID de la brand desde ocoya_list_brands. |
postGroupId | string | Yes | ID del grupo de posts de Ocoya. |
Request example
{
"name": "ocoya_delete_post",
"arguments": {
"brandId": "cmayvq3hk00017apshay5qezu",
"postGroupId": "cmajvvb9q0003ja5vh0538j6r"
}
}Deleting on the network
Si el post ya se había publicado, al borrarlo aquí también se borra la copia publicada
en Facebook, Instagram, X, LinkedIn, Pinterest, Threads, Google Business,
YouTube, Bluesky, Mastodon, Telegram, Slack, Discord, Dribbble, Tumblr,
WordPress, Webflow (el elemento se despublica y se elimina de su colección)
y Kick. Notion, Airtable y Wix mueven la página, fila o entrada de blog a su papelera. Framer
quita el elemento de su colección, y deja de estar en el sitio en vivo la próxima vez
que se publique el proyecto — borrar nunca publica el proyecto. DEV.to no tiene opción de borrado, así que un artículo vuelve a borrador; a un canal personalizado (webhook) se le envía
una petición post.deleted, si estaba conectado con una URL de borrado.
Cuatro redes no pueden hacerlo en absoluto y se informa de ello: TikTok, Snapchat y Whop no publican ningún endpoint de borrado, y Twitch se niega a borrar los mensajes de chat del propio broadcaster.
Que una red se niegue nunca hace fallar la llamada — el post siempre se borra en Ocoya —
así que consulta networkDeletes para saber si sigue habiendo una copia activa. Un post que se sincronizó desde una red en lugar de publicarse con Ocoya solo se elimina de Ocoya.
Returns
Devuelve el ID del grupo de posts borrado, un booleano deleted y networkDeletes:
un elemento por cada canal donde se publicó, con provider, providerName,
socialProfileId, status y, cuando hay algo que decir, message.
status es uno de:
| Status | Meaning |
|---|---|
deleted | Eliminado de la red. |
already-gone | No había nada — ya se había borrado o nunca se publicó. |
unsupported | Esta red no tiene API de borrado. El post sigue activo. |
failed | La red lo ha rechazado. El post sigue activo; message indica el motivo. |
{
"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."
}
]
}