TagMangoTagMango Docs
Mango

Delete Mango

DELETE
/api/v1/external/mangos/{mangoId}

Deletes one active Mango owned by the authenticated creator. Use List Mangoes to select the Mango. The platform-managed signup Mango cannot be deleted.

Important effects

  • This action cannot be undone.
  • Related selling, content, and access data is removed; consultation events are permanently deleted.
  • Empty courses, posts, and video-call slots may be hidden platform-wide, including resources not linked to this Mango.

Deferred cleanup

Subscription cancellations, subscriber access removal, and room updates may finish after success and are retried automatically.

Retry behavior

Deletion is not atomic, so a failed request may leave earlier changes applied. After a 500 response, check List Mangoes before retrying. If the Mango no longer appears, retrying returns MANGO_NOT_FOUND and does not resume cleanup.

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

mangoId*string

The 24-character hexadecimal ID of the owned Mango addressed by this operation. Obtain it from List Mangoes or the result._id returned by Create Mango.

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

application/json

curl -X DELETE "https://api-prod-new.tagmango.com/api/v1/external/mangos/6a8ec3908384d1f9507e7c2c" \  -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": "WORKSHOP_MANGO_FORBIDDEN",
  "message": "You can not access this api with a TagMango account, only available for whitelabel hosts",
  "result": "You can not access this api with a TagMango account, only available for whitelabel hosts",
  "success": false
}
{
  "code": 404,
  "type": "Not Found",
  "statusMessage": "NOT_FOUND",
  "errorCode": "MANGO_NOT_FOUND",
  "message": "No active Mango owned by the authenticated creator matches `mangoId`. Missing, deleted, and foreign Mangoes intentionally share this response. Refresh [List Mangoes](https://docs.tagmango.com/docs/api-reference/mango/listMangoesByCreator) and use an ID returned for this creator.",
  "result": "No active Mango owned by the authenticated creator matches `mangoId`. Missing, deleted, and foreign Mangoes intentionally share this response. Refresh [List Mangoes](https://docs.tagmango.com/docs/api-reference/mango/listMangoesByCreator) and use an ID returned for this creator.",
  "success": false
}
{
  "code": 409,
  "type": "Conflict",
  "statusMessage": "CONFLICT",
  "errorCode": "MANGO_SYSTEM_MANAGED",
  "message": "The selected Mango is the platform-managed signup service. Choose another Mango; this service cannot be deleted.",
  "result": "The selected Mango is the platform-managed signup service. Choose another Mango; this service cannot be deleted.",
  "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
}
Empty