> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bukiopay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Remover Categoria — DELETE /api/v1/categories/:id

> Remove permanentemente uma categoria da loja pelo ID. Verifique se há produtos vinculados antes de excluir. A operação é irreversível e imediata.

Use este endpoint para excluir uma categoria da sua loja. Após a remoção, a categoria deixará de aparecer no catálogo e não poderá ser recuperada. Verifique se não há produtos vinculados à categoria antes de prosseguir com a exclusão.

## Método

`DELETE /api/v1/categories/:id` — Requer autenticação.

## Parâmetro de Rota

<ParamField path="id" type="string" required>
  Identificador único da categoria a ser removida (ex: `cat_123`).
</ParamField>

<Warning>
  Esta operação é **irreversível**. Uma vez deletada, a categoria não pode ser recuperada. Certifique-se de que deseja realmente excluí-la antes de realizar a requisição.
</Warning>

## Exemplo de Requisição

```bash theme={null}
curl -X DELETE 'https://api.bukiopay.com/api/v1/categories/cat_123' \
  --header 'Authorization: Bearer sk_live_sua_api_key'
```

## Resposta

```json theme={null}
{
  "message": "Categoria deletada com sucesso"
}
```

## Campos da Resposta

<ResponseField name="message" type="string">
  Mensagem de confirmação indicando que a categoria foi removida com sucesso.
</ResponseField>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.