Pular para o conteúdo principal
PUT
Update category

📌 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


🧾 Body

Envie apenas os campos que deseja alterar.

✅ Exemplo de requisição


📦 Resposta de sucesso (200)


⚠️ Possíveis erros

  • 400 INVALID_DATA → payload vazio/inválido ou parâmetros inválidos
  • 400 INVALID_DATA_NAME_MIN → name com menos de 4 caracteres
  • 400 INVALID_DATA_NAME_MAX → name com mais de 32 caracteres
  • 400 INVALID_DATA_DESCRIPTION_MIN → description com menos de 12 caracteres
  • 400 INVALID_DATA_DESCRIPTION_MAX → description com mais de 256 caracteres
  • 400 INVALID_DATA_IMAGE → image fora do intervalo de 12 a 512 caracteres
  • 400 INVALID_DATA_POSITION → position menor que 1
  • 400 NAME_ALREADY_EXISTS → categoria com mesmo nome
  • 401 API_KEY_NOT_PROVIDED → header Authorization não enviado (ou TOKEN_NOT_PROVIDED via Bearer)
  • 401 INVALID_API_KEY → API Key inválida (ou INVALID_TOKEN / TOKEN_EXPIRED / SESSION_NOT_FOUND / SESSION_EXPIRED / UNAUTHENTICATED via Bearer)
  • 403 USER_DISABLED → usuário desativado ou excluído
  • 403 NO_ACTIVE_SUBSCRIPTION → plano inativo ou expirado (ou PENDING_2FA via Bearer)
  • 403 STORE_NOT_FOUND → loja não encontrada ou sem permissão
  • 404 CATEGORY_NOT_FOUND → categoria não encontrada
  • 429 RATE_LIMIT_EXCEEDED → limite de requisições por minuto excedido
  • 500 INTERNAL_SERVER_ERROR → erro interno
  • 503 SERVICE_UNAVAILABLE → serviço ou banco de dados indisponível

Autorizações

Authorization
string
header
padrão:YOUR_API_KEY_HERE
obrigatório

Parâmetros de caminho

storeId
string
obrigatório
Required string length: 1 - 50
categoryId
string
obrigatório
Required string length: 1 - 50

Corpo

application/json

Category fields to update.

name
string
Required string length: 4 - 32
description
string
Required string length: 12 - 256
image
string
Required string length: 12 - 512
metadata
object
position
integer
Intervalo obrigatório: x >= 1

Resposta

Update category.

code
string
obrigatório
Exemplo:

"CATEGORY_UPDATED"

category
object
obrigatório

Store product category.