Update profile

Update an existing profile name and administrator flag.

PUT /api/perfil/:id

Updates the strNombrePerfil and bitAdministrador fields of an existing profile. The endpoint also manages permisos_perfil records automatically based on the change in administrator status:

• Was not admin → now admin: all existing permissions for this profile are deleted and replaced with full permissions for every existing module.
• Was admin → no longer admin: all permissions for this profile are deleted, leaving the profile with no module access.
• No change to admin flag: existing permissions are left unchanged.

Path parameters

id · number · required

Primary key of the profile to update.

Request body

strNombrePerfil · string · required

Updated profile name. Cannot be empty or whitespace-only.

bitAdministrador · boolean · required

Updated administrator flag.

Response

success · boolean · required

true when the update completes without error.

data · object · required

The updated profile record as returned by the database.

Show properties

id · number

Primary key.

strNombrePerfil · string

Updated profile name.

bitAdministrador · boolean

Updated administrator flag.

Error responses

Status	Message	Cause
400	ID de perfil inválido	The :id path segment is missing or resolves to 0 or NaN.
400	El nombre es obligatorio	strNombrePerfil is missing or is an empty/whitespace string.
404	Perfil no encontrado	No record exists with the given id.
500	Ocurrió un error interno al actualizar el perfil	Any other unhandled database error.

Examples

curl

curl --request PUT \
  --url https://your-domain.com/api/perfil/4 \
  --header 'Content-Type: application/json' \
  --cookie 'auth_token=<your-jwt>' \
  --data '{
    "strNombrePerfil": "Supervisor Senior",
    "bitAdministrador": false
  }'

Success response

200

{
  "success": true,
  "data": {
    "id": 4,
    "strNombrePerfil": "Supervisor Senior",
    "bitAdministrador": false
  }
}

Error response (404)

404

{
  "statusCode": 404,
  "message": "Perfil no encontrado"
}