deleteBrand
Requires permission products:brand:delete.
Deletes a brand. A brand that still has products is refused; move or remove its products first. Needs the brands delete permission.
Errors: a failed call returns a GraphQL errors entry, not a field on the result, and data may be null or partial. Read the entry's extensions.code and message; every shape and code is in the Error reference.
Example:
- GraphQL
- cURL
mutation DeleteBrand($id: ID!) {
deleteBrand(id: $id) {
id
code
name
createdAt
deletedAt
deletedBy
products {
id
name
status
createdAt
basePrice
baseUOMId
}
}
}
curl -X POST "https://<api-host>/graphql" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
--data @- <<'EOF'
{
"query": "mutation DeleteBrand($id: ID!) {\n deleteBrand(id: $id) {\n id\n code\n name\n createdAt\n deletedAt\n deletedBy\n products {\n id\n name\n status\n createdAt\n basePrice\n baseUOMId\n }\n }\n}",
"variables": {
"id": "id"
}
}
EOF
Variables:
{
"id": "id"
}
Response:
{
"data": {
"deleteBrand": {
"id": "id",
"code": "string",
"name": "string",
"createdAt": "2025-01-15T00:00:00Z",
"deletedAt": "2025-01-15T00:00:00Z",
"deletedBy": "string",
"products": [
{
"id": "id",
"name": "string",
"status": "ACTIVE",
"createdAt": "2025-01-15T00:00:00Z",
"basePrice": 0,
"baseUOMId": "id"
}
]
}
}
}
deleteBrand(
id: ID!
): Brand!
Arguments
deleteBrand.id ● ID! non-null scalar
The ID of the brand.
Type
Brand object
A brand products are made or sold under.