Saltar al contenido principal
PUT
Update category

📌 Endpoint

PUT /stores/{storeId}/categories/{categoryId} Actualiza los datos de una categoría existente.

🔐 Autenticación

  • Ruta privada.
  • Envíe Authorization con su API Key.

🧾 Parámetros de ruta


🧾 Body

Envíe solo los campos que desea cambiar.

✅ Ejemplo de solicitud


📦 Respuesta exitosa (200)


⚠️ Posibles errores

  • 400 INVALID_DATA → payload vacío/inválido o parámetros inválidos
  • 400 INVALID_DATA_NAME_MIN → name con menos de 4 caracteres
  • 400 INVALID_DATA_NAME_MAX → name con más de 32 caracteres
  • 400 INVALID_DATA_DESCRIPTION_MIN → description con menos de 12 caracteres
  • 400 INVALID_DATA_DESCRIPTION_MAX → description con más de 256 caracteres
  • 400 INVALID_DATA_IMAGE → image fuera del intervalo de 12 a 512 caracteres
  • 400 INVALID_DATA_POSITION → position menor que 1
  • 400 NAME_ALREADY_EXISTS → categoría con el mismo nombre
  • 401 API_KEY_NOT_PROVIDED → header Authorization no enviado (o TOKEN_NOT_PROVIDED vía Bearer)
  • 401 INVALID_API_KEY → API Key inválida (o INVALID_TOKEN / TOKEN_EXPIRED / SESSION_NOT_FOUND / SESSION_EXPIRED / UNAUTHENTICATED vía Bearer)
  • 403 USER_DISABLED → usuario desactivado o eliminado
  • 403 NO_ACTIVE_SUBSCRIPTION → plan inactivo o expirado (o PENDING_2FA vía Bearer)
  • 403 STORE_NOT_FOUND → tienda no encontrada o sin permiso
  • 404 CATEGORY_NOT_FOUND → categoría no encontrada
  • 429 RATE_LIMIT_EXCEEDED → límite de solicitudes por minuto excedido
  • 500 INTERNAL_SERVER_ERROR → error interno
  • 503 SERVICE_UNAVAILABLE → servicio o base de datos no disponible

Autorizaciones

Authorization
string
header
predeterminado:YOUR_API_KEY_HERE
requerido

Parámetros de ruta

storeId
string
requerido
Required string length: 1 - 50
categoryId
string
requerido
Required string length: 1 - 50

Cuerpo

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
Rango requerido: x >= 1

Respuesta

Update category.

code
string
requerido
Ejemplo:

"CATEGORY_UPDATED"

category
object
requerido

Store product category.