VenddorDocumentação API
API atualAPI legada
Guia rápidoReferência completa
Carregando índice…
API atual/Guia rápido/Grupos de características

Excluir grupo

Remove um grupo de características; as características que estavam nele continuam e ficam sem grupo.

Use esta operação para apagar um grupo que não é mais necessário. A exclusão não leva as características junto: elas continuam existindo, com os valores dos produtos intactos, e passam a ter group_id vazio (continuam com o categories_path que já tinham). A exclusão é permanente e não tem desfazer.

DELETE/api/v1/admin/feature-groups/{id}Admin

Excluir um grupo de características

Exige o privilégio manage_features. Responde 200 com uma mensagem.

Parâmetros de caminho

iduuidobrigatório
Id do grupo.
DELETE/api/v1/admin/characteristic-groups/{id}Admin

Apelido em português: excluir um grupo de características

Apelido de /api/v1/admin/feature-groups/{id}: mesmas regras e mesma resposta.

Exemplo de requisição

bash
curl -X DELETE "$BASE_URL/api/v1/admin/feature-groups/7c1221b4-ddb6-468c-b17e-be1dc5e7c888" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Grupo excluído
json
{ "message": "feature deleted" }

Erros

StatusQuandoCorpo
401Sem credenciais ou token expirado{"error":"missing authorization header"}
403Sem o privilégio manage_features{"error":"insufficient privileges","required":"manage_features"}
500Grupo inexistente, ou id que não é UUID{"error":"failed to delete feature","detail":"feature not found"}
A rota não confere se o id é de um grupo

O id de uma característica comum também é aceito por esta rota, e ela será excluída (se nenhum produto tiver valor nela). Confira o feature_type do registro em Consultar grupo antes de excluir.

Veja também

  • Listar grupos
  • Alterar grupo
  • Excluir característica
Anterior
Alterar grupo
Próxima
Embalagens e caixas
Nesta página
  • Exemplo de requisição
  • Resposta
  • Erros
  • Veja também