---
title: "Delete Brand Kit"
method: DELETE
path: "/brand-kits/{brand_kit_id}"
tags: ["brand-kits"]
---

# Delete Brand Kit

`DELETE /brand-kits/{brand_kit_id}`

Soft-delete a brand kit.

Returns ``204 No Content`` on success. Returns ``404 not_found`` if the
brand kit does not exist, has already been deleted, or the caller lacks
team access — the three cases are collapsed so the endpoint does not leak
existence of brand kits in other teams.

## Path parameters

- `brand_kit_id` string, required — Prefixed ``bk_`` wire ID (Crockford base32 body) — the canonical, recommended form. For back-compat, **a bare UUID string is also accepted** in both path parameters and JSON request bodies (older integrations that stored raw UUIDs keep working). Both are permanent, supported inputs.

## Headers

- `Moda-Version` '2026-04-12' | '2026-05-01'

## Response `204`

Successful Response

## Other responses

- `401` — Authentication required.
- `403` — Permission denied for this scope.
- `404` — Resource not found.
- `409` — Conflict (idempotency / resource state).
- `422` — Request validation failed.
- `429` — Rate limit exceeded.
- `500` — Internal error.

---

[API](https://skmtc.dev/moda/apis/moda-public-api.md) · [All operations](https://skmtc.dev/moda/apis/moda-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/moda/moda-public-api/revisions/b34cb4cca59e/schema)