Skip to main content

​
📌 Endpoint

PUT /stores/:storeId/categories/:categoryId Atualiza os dados de uma categoria existente.

​
🔐 Autenticação

  • Rota privada.
  • Envie Authorization com sua API Key.

​
🧾 Parâmetros de rota

ParâmetroTipoObrigatórioDescrição
storeIdstringSimID da loja
categoryIdstringSimID da categoria

​
🧾 Body

Envie apenas os campos que deseja alterar.
CampoTipoObrigatórioRegras
namestringNão4 a 32 caracteres
descriptionstringNão12 a 256 caracteres
imagestringNãoURL entre 12 e 512 chars
positionnumberNãointeiro maior ou igual a 1

​
✅ Exemplo de requisição

curl -X PUT "https://api.cabrapi.com.br/stores/STORE_ID/categories/CATEGORY_ID" \
	-H "Authorization: SUA_API_KEY" \
	-H "Content-Type: application/json" \
	-d '{
		"name": "Eletrônicos Premium",
		"description": "Categoria atualizada"
	}'

​
📦 Resposta de sucesso (200)

{
	"status": true,
	"code": "CATEGORY_UPDATED",
	"category": {
		"id": "CATEGORY_ID",
		"name": "Eletrônicos Premium",
		"description": "Categoria atualizada",
		"image": null,
		"position": 2,
		"storeId": "STORE_ID",
		"createdAt": "2026-03-02T20:00:00.000Z",
		"updatedAt": "2026-03-02T21:00:00.000Z"
	}
}

​
⚠️ Possíveis erros

  • 400 INVALID_DATA → payload inválido
  • 400 NAME_ALREADY_EXISTS → categoria com mesmo nome
  • 403 STORE_NOT_FOUND → loja não encontrada ou sem permissão
  • 404 CATEGORY_NOT_FOUND → categoria não encontrada
  • 500 INTERNAL_SERVER_ERROR → erro interno