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

# Excluir Produto

> Desative um produto existente

## Visão Geral

Este endpoint realiza uma **exclusão suave** (soft delete) do produto, definindo `isActive: false`. Os dados do produto são preservados para histórico de transações.

<Warning>
  Após excluir um produto, o link de pagamento deixará de funcionar. Clientes que tentarem acessar receberão uma mensagem de produto indisponível.
</Warning>

## Parâmetros de Path

<ParamField path="id" type="number" required>
  ID do produto a ser excluído.
</ParamField>

## Exemplo de Requisição

<CodeGroup>
  ```bash cURL theme={null}
  curl -X DELETE https://garu.com.br/api/products/123 \
    -H "Authorization: Bearer sk_test_sua_chave_api"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://garu.com.br/api/products/123', {
    method: 'DELETE',
    headers: {
      'Authorization': `Bearer ${process.env.GARU_API_KEY}`
    }
  });

  if (response.status === 204) {
    console.log('Produto excluído com sucesso');
  }
  ```

  ```python Python theme={null}
  import requests
  import os

  url = "https://garu.com.br/api/products/123"
  headers = {
      "Authorization": f"Bearer {os.environ['GARU_API_KEY']}"
  }

  response = requests.delete(url, headers=headers)

  if response.status_code == 204:
      print("Produto excluído com sucesso")
  ```
</CodeGroup>

## Resposta de Sucesso

**204 No Content** - Produto excluído com sucesso. Nenhum corpo na resposta.

## Erros Comuns

<AccordionGroup>
  <Accordion title="404 - Produto não encontrado">
    ```json theme={null}
    {
      "statusCode": 404,
      "message": "Product not found"
    }
    ```

    **Solução:** Verifique se o ID do produto está correto.
  </Accordion>

  <Accordion title="403 - Sem permissão">
    ```json theme={null}
    {
      "statusCode": 403,
      "message": "Insufficient permissions"
    }
    ```

    **Solução:** Você só pode excluir produtos criados com sua conta.
  </Accordion>
</AccordionGroup>

## Comportamento

* O produto é marcado como `isActive: false`
* O link de pagamento para de funcionar
* Os dados permanecem no sistema para histórico
* Transações anteriores não são afetadas

<Tip>
  Se você quiser reativar um produto, use o endpoint de atualização para definir `isActive: true`.
</Tip>

## Próximos Passos

<CardGroup cols={2}>
  <Card title="Criar Produto" icon="plus" href="/api-reference/produtos/criar">
    Crie um novo produto
  </Card>

  <Card title="Listar Produtos" icon="list" href="/api-reference/produtos/listar">
    Veja todos os seus produtos
  </Card>
</CardGroup>