Endpoints / Usuarios

PATCH

Actualizar usuario

Actualiza parcialmente los datos editables de un usuario, dentro de la empresa del usuario autenticado, incluyendo nombre, correo, imagen, rol y estado.

PATCH/users/:id

cURLPor defecto

curl -X PATCH "https://api.ferreconst.space/users/2a6eb0a9-10e1-49fb-a2f3-1e5c580f5a07"   -H "Authorization: Bearer <token>"   -H "Content-Type: application/json"   -d '{
    "usnombre": "Juan Perez",
    "uscorreo": "juan.perez@empresa.com",
    "usrol": "empleado"
  }'

Respuesta200 OK

{  "usid": "2a6eb0a9-10e1-49fb-a2f3-1e5c580f5a07",  "usemid": "0f4c5bde-9a11-4c76-9b6a-2e0b58e9bc2a",  "usnombre": "Juan Perez",  "usapodo": "jperez",  "uscorreo": "juan.perez@empresa.com",  "usimagen": "https://api.ferreconst.space/uploads/usuarios/user.png",  "usrol": "empleado",  "usfchregistro": "2026-05-18T18:20:10.000Z",  "usestado": "activo"}

Caso de Uso

Se usa cuando la aplicación necesita modificar el nombre, correo, imagen de perfil, rol o estado de un usuario existente. Al usarlo, el usuario obtiene los datos completos del usuario actualizado, con la URL pública de su imagen de perfil.

Autenticación

Requiere token JWT en el header `Authorization: Bearer <token>`. Permite acceso a usuarios con rol administrador, jefe o empleado, con reglas adicionales para cambiar usrol o usestado.

Parámetros de ruta

idstringobligatorio

Identificador del usuario a actualizar.

Body

usnombrestring opcional

Nuevo nombre del usuario; debe contener solo letras y espacios.

uscorreostring opcional

Nuevo correo electrónico del usuario; debe tener formato válido y ser único globalmente.

usestadostring opcional

Nuevo estado del usuario. Valores: activo, inactivo, eliminado.

usrolstring opcional

Nuevo rol del usuario. Valores: administrador, jefe, empleado.

imagenfile opcional

Nueva imagen de perfil del usuario; solo se aceptan .png o .jpg de hasta 5 MB.

Reglas de negocio

Solo permite actualizar usuarios de la misma empresa del usuario autenticado.

El usuario autenticado debe estar activo.

La empresa del usuario autenticado debe estar activa.

Los roles permitidos para este endpoint son jefe, empleado o administrador.

Si se envía usrol o usestado, solo un usuario con rol jefe puede cambiarlo.

Si se envía usrol o usestado, el usuario objetivo debe tener rol jefe o empleado (no administrador).

Si el usuario objetivo está en estado eliminado, no se permite actualizar.

Debe enviarse al menos un campo para actualizar.

Si se envía uscorreo y ya existe, se retorna error de negocio.

El backend transforma usimagen a URL pública completa.

Campo: imagen

Formatos permitidos: .png, .jpg

Tamaño máximo: 5MB

Errores esperados

401Token inválido o ausente

400ID de usuario requerido

id inválido o ausente

500Se requiere al menos un campo para actualizar

Body sin campos para actualizar

500Nombre requerido, El nombre debe contener solo letras y espacios

usnombre ausente o inválido

500Correo requerido, El correo debe ser válido

uscorreo ausente o inválido

500Imagen de usuario requerida

usimagen vacía

500Estado de usuario requerido

usestado vacío

500El usuario no está activo (estado inválido)

usestado inválido

500Rol requerido, El rol debe ser válido

usrol ausente o inválido

500El tamaño de la imagen excede el límite permitido, Solo se permiten imágenes PNG y JPG

Imagen inválida

500El usuario ya existe con ese correo

Correo duplicado

500Usuario no encontrado

Usuario objetivo no encontrado

500No se puede actualizar un usuario eliminado

Usuario objetivo eliminado

500El usuario no es jefe

Usuario autenticado sin rol jefe al cambiar usrol o usestado

500El rol debe ser jefe o empleado

Usuario objetivo con rol fuera de jefe o empleado al cambiar usrol o usestado

500La empresa no está activa

Empresa inactiva

500El usuario no está activo

Usuario autenticado inactivo

Notas de uso

Este endpoint no recibe query params.

Envía solo los campos que deseas actualizar.

Si no se envía imagen, usa Content-Type: application/json.

Si se envía imagen, usa Content-Type: multipart/form-data con el archivo en el campo imagen.

No se permite cambiar el apodo (usapodo) mediante este endpoint.

Para cambiar solo el estado, existe el endpoint PATCH /users/:id/status.

Para cambiar solo la contraseña, existe el endpoint PATCH /users/:id/password.