---
title: "Delete a brand"
method: DELETE
path: "/v2/settings/brands/{brand-id}"
tags: ["Brands Api Service"]
---

# Delete a brand

`DELETE /v2/settings/brands/{brand-id}`

## Request

- Base URL: `https://app.metricool.com/api`
- URL: `https://app.metricool.com/api/v2/settings/brands/{brand-id}`
- Auth: none declared

Deletes the specified brand. If the brand is associated with a WhiteLabel Integrator, the agencyId must be provided in the request body. A team member whose organization role grants manageBrands may also delete a brand of that organization, with no extra field: the organization is the brand owner's. A role with only editBrand cannot, and gets 404 like any other brand not its own. Additionally, an optional maxRecoveryDays (max 45 days) can be specified to set the recovery period for the deleted brand.

## Path parameters

- `brand-id` integer, required

## Request body

- DeleteBrandRequest: Request to delete a brand
  - `maxRecoveryDays` integer: Max recovery days for the deleted brand (max 45 days)
  - `agencyId` integer: Brand agency id (if the brand belongs to an agency)

## Response `200`

OK

- JsonOkResponseBoolean
  - `metadata` object
  - `page` JsonPaging
    - `next` string
  - `data` boolean

---

[API](https://skmtc.dev/metricool/apis/metricool-api.md) · [All operations](https://skmtc.dev/metricool/apis/metricool-api/llms.txt) · [OpenAPI document](https://skmtc.dev/metricool/apis/metricool-api/revisions/cd0ca612fa01?raw)