Developers
Acessar miCore Começar
Atualizado em 17 de outubro de 2026
SOLUÇÃO

Gerenciar categorias

Cria, edita e desativa categorias de produto pela API, para a integração montar o catálogo sem passar pelo painel.

Considerações

  • Exige o escopo product-categories:write e a permissão correspondente em Categorias.
  • Criar é idempotente (envie um Idempotency-Key); nome duplicado é recusado com 422.
  • Use parent_id para criar subcategoria (o pai precisa existir).
  • Desativar (DELETE) arquiva sem apagar; reativar é pelo painel.

Referência

POST /product-categories na Referência da API PATCH /product-categories/{productCategory} DELETE /product-categories/{productCategory}

Como fazer

cURL
curl -X POST "$MICORE_BASE_URL/product-categories" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Idempotency-Key: request-2026-0001" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Vestuário",
    "parent_id": null
}'

Resposta

Resposta · 201
{
  "data": { "id": 4, "name": "Vestuário", "parent_id": null, "status": true }
}
Precisa de ajuda?Use o request ID e abra um chamado no miCore se encontrar uma divergência.