Delete Brand API
This API endpoint permanently deletes a brand (customer account) using its brand_id. This action is irreversible and will remove all associated data, including social accounts, posts, and settings.
Warning: This is a destructive operation. Always confirm with the client before deleting a brand. No recovery is possible after deletion.
- Method: POST (implemented as POST with JSON body for compatibility)
- Endpoint:
/api/api-services/v1/brand-service/delete-brand - Authentication: Required (Bearer token)
- Returns: Success message on deletion
Delete Brand
POST https://app.brand2social.com/api/api-services/v1/brand-service/delete-brand
Example Request Body (JSON)
Visual examples of DELETE-style requests in API testing tools (note: this endpoint uses POST with body):
Always show a confirmation dialog in your application UI before calling this endpoint:
| Field | Type | Required | Description |
|---|---|---|---|
| brand_id | integer | Yes | The numeric ID of the brand to permanently delete (obtained from Get All Brands API) |
curl --location --request POST 'https://app.brand2social.com/api/api-services/v1/brand-service/delete-brand' \
--header 'Authorization: Bearer B2S_dummyToken' \
--header 'Content-Type: application/json' \
--data-raw '{
"brand_id": 12345
}'Success Response
{
"status": "SUCCESS",
"http_code": 200,
"message": "Successfully deleted brand",
"data": null
}Error Response Example
{
"status": "FAILURE",
"http_code": 400,
"message": "Error in deleting brand",
"data": ""
}Best Practices:
• Fetch the list of brands first to confirm the correct brand_id.
• Implement client-side confirmation to prevent accidental deletions.
• This endpoint is typically restricted to organization admins or resellers.