Update user

PUT /api/usuario/:id Updates the fields of an existing user. The core text fields (strNombreUsuario, idPerfil, strCorreo, strNumeroCelular, idEstadoUsuario) are always overwritten. imagenUrl is only updated when a new imagenBase64 value is provided — omitting it leaves the existing photo URL unchanged. strPwd is only re-hashed and updated when a non-empty string is provided.

Path parameters

number

required

Primary key of the user to update.

Request body

string

required

Updated username.

number

required

Updated profile (role) ID.

string

required

Updated email address.

string

Updated phone number.

boolean

required

Updated active status. true = active, false = inactive.

string

New plain-text password. If this field is present and non-empty, it is hashed with bcrypt (10 rounds) and replaces the stored hash. Omit or send an empty string to leave the password unchanged.

string

Base64-encoded replacement image (must start with data:image). When provided, a new image is uploaded to the usuarios_corp Cloudinary folder and imagenUrl is updated to the new secure URL. If omitted, the existing imagenUrl is not modified.

Response

boolean

required

true when the update completes without error.

object

required

The updated user record as returned by the database.

Show properties

number

Primary key.

string

Username.

number

Profile ID.

string

Bcrypt hash of the current password.

string

Email address.

string | null

Phone number.

boolean

Active status.

string | null

Cloudinary URL of the profile image.

Error responses

Status	Message	Cause
`500`	`Error al actualizar: la imagen es demasiado grande o el servidor tardó demasiado.`	Cloudinary upload failed, the image payload is too large, or the request timed out.

The handler does not return a 404 if the id does not match any record — it will return success: true with data set to undefined. Validate the response data field on the client if you need to confirm the record existed.

Examples

curl --request PUT \
  --url https://your-domain.com/api/usuario/12 \
  --header 'Content-Type: application/json' \
  --cookie 'auth_token=<your-jwt>' \
  --data '{
    "strNombreUsuario": "jdoe",
    "idPerfil": 2,
    "strCorreo": "jdoe-updated@example.com",
    "strNumeroCelular": "555-0000",
    "idEstadoUsuario": true
  }'

const response = await fetch('/api/usuario/12', {
  method: 'PUT',
  headers: { 'Content-Type': 'application/json' },
  credentials: 'include',
  body: JSON.stringify({
    strNombreUsuario: 'jdoe',
    idPerfil: 2,
    strCorreo: 'jdoe-updated@example.com',
    strNumeroCelular: '555-0000',
    idEstadoUsuario: true,
    // strPwd: 'newPassword', // include only if changing the password
    // imagenBase64: 'data:image/png;base64,...', // include only if uploading a new image
  }),
});

const { success, data } = await response.json();

Success response

200

{
  "success": true,
  "data": {
    "id": 12,
    "strNombreUsuario": "jdoe",
    "idPerfil": 2,
    "strPwd": "$2b$10$...",
    "strCorreo": "jdoe-updated@example.com",
    "strNumeroCelular": "555-0000",
    "idEstadoUsuario": true,
    "imagenUrl": "https://res.cloudinary.com/demo/image/upload/usuarios_corp/sample.jpg"
  }
}

Authentication

Users

Profiles

Modules

Permissions

Path parameters

Request body

Response

Error responses

Examples

Success response

​Path parameters

​Request body

​Response

​Error responses

​Examples

​Success response

Path parameters

Request body

Response

Error responses

Examples

Success response