Ir al contenido

Actualizar una categoría

PUT/api/category/{id}

Actualiza una categoría. Rellena los campos recibidos, registra al usuario autenticado en update_user_id y responde 200 con el registro actualizado. El level no se recalcula: si cambias category_father_id, el nivel guardado sigue siendo el anterior.

idintegerobligatorio

Identificador de una categoría.

namestringobligatorio

Nombre de la categoría. Máximo 60 caracteres; solo letras, números y espacios. Debe ser único, también frente a categorías eliminadas.

descriptionstring

Descripción. Máximo 500 caracteres.

category_father_idinteger

Categoría padre. Debe existir en categorías. Si se omite, la categoría es raíz.

filestring

Se acepta en la validación, pero CategoryController no lo procesa (el código que guardaba la imagen está comentado).

file_extensionstring

Se acepta en la validación, pero CategoryController no lo procesa.

quotation.configuration.edit, que se valida en CategoryPolicy::update.

Ventana de terminal
curl -X PUT \
"https://servererp.allendostmen.app/api/category/1" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"name": "Cables y conductores",
"description": "Cables eléctricos"
}'
Categoría actualizada200
{
"id": 1,
"name": "Cables y conductores",
"description": "Cables eléctricos",
"image": null,
"thumbnail": null,
"level": 1,
"category_father_id": null,
"status": "activo",
"previous_status": null,
"status_update_comment": null,
"status_update_date": null,
"status_update_user_id": null,
"create_user_id": 1,
"update_user_id": 1,
"delete_user_id": null,
"restore_user_id": null,
"created_at": "2026-11-19T10:40:15.000000Z",
"updated_at": "2026-11-19T11:15:00.000000Z",
"deleted_at": null
}
Error de validación422
{
"message": "El nombre de la categoría ya existe.",
"errors": {
"name": [
"El nombre de la categoría ya existe."
]
}
}
No encontrado404
{
"message": "No query results for model [App\\Models\\Category] 3"
}
Sin permiso403
{
"message": "This action is unauthorized."
}