Delete a post in a community channel
deleteFromAllChannels is required on every call — omitting it entirely fails. Any value other than true (including a malformed one) is treated as false, which only removes the post from this one channel — if it's also published to other channels, it remains there untouched. true removes it everywhere and deletes the post itself, not just its presence here; this cannot be undone either way.
Authored as the creator by default: actingUserId is required to delete as anyone else — see that field's own description for exactly who is allowed to delete a given post (the creator, the post's own author, or a moderator with delete-post access).
Fails with a 400 if deleteFromAllChannels is omitted, if actingUserId is a creator/team-member account, or if a moderator is given together with deleteFromAllChannels: true.
External access policy
An API key and an authorized white-label host are required. Both tier and plan requirements are enforced.
These requirements apply to the white-label creator for backend-to-backend access. TagMango platform access is not supported.
-
Plans: Unrestricted.
-
Tiers: Unrestricted.
Authorization
bearer In: header
Path Parameters
Id of the community channel the post belongs to
Id of the post to delete — this is the channel-post id (the top-level _id from the listing/get-one response), not the nested post._id. The same post published to several channels has a different id in each one; always use the id returned for this specific channel. By default only this one channel is affected — see deleteFromAllChannels below to remove it everywhere instead.
Query Parameters
Whether to also delete this post from every other channel it was published to, and the post itself, not just its presence in this one channel. Required — omitting it entirely is rejected. Any value other than true (including a malformed one) is treated as false. Only the creator or the post's own original author can pass true — a moderator (via actingUserId) is always restricted to deleting the post from this one channel, and true is rejected outright if actingUserId resolves to a moderator rather than the creator/author.
Header Parameters
Host name of the dashboard, ex: mydomain.tagmango.com
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X DELETE "https://api-prod-new.tagmango.com/api/v1/external/community/channels/61e97c146cf2b4d8c68f3a40/posts/61e97c146cf2b4d8c68f3a4a?deleteFromAllChannels=false" \ -H "x-whitelabel-host: string"{
"code": 400,
"type": "Bad Request",
"statusMessage": "BAD_REQUEST",
"success": false,
"message": "Invalid request",
"result": "Invalid request"
}{
"code": 401,
"type": "Unauthorized",
"statusMessage": "UNAUTHORIZED",
"message": "Invalid token",
"result": "Invalid token",
"success": false
}{
"code": 403,
"type": "Forbidden",
"statusMessage": "FORBIDDEN",
"errorCode": "CHANNEL_POST_ACCESS_FORBIDDEN",
"message": "A `userId` was provided, but that member has no active subscription or badge granting access to this channel (or the channel is hidden). Distinct from the 401 returned for an invalid/missing API key.",
"result": "A `userId` was provided, but that member has no active subscription or badge granting access to this channel (or the channel is hidden). Distinct from the 401 returned for an invalid/missing API key.",
"success": false
}{
"code": 404,
"type": "Not Found",
"statusMessage": "NOT_FOUND",
"errorCode": "CHANNEL_POST_CHANNEL_NOT_FOUND",
"message": "The channel does not exist, is archived, or the community feature is not active for this creator.",
"result": "The channel does not exist, is archived, or the community feature is not active for this creator.",
"success": false
}{
"code": 429,
"type": "Too Many Requests",
"statusMessage": "TOO_MANY_REQUESTS",
"message": "Request limit exceeded. try after 10 seconds",
"result": "Request limit exceeded. try after 10 seconds",
"success": false
}