TagMangoTagMango Docs
Community

Delete a post in a community channel

DELETE
/api/v1/external/community/channels/{channelId}/posts/{postId}

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.

AuthorizationBearer <token>

In: header

Path Parameters

channelId*string

Id of the community channel the post belongs to

postId*string

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

deleteFromAllChannels*boolean

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

x-whitelabel-host*string

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"
Empty
{
  "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
}