Delete profile

DELETE /api/perfil/:id Permanently removes a profile and all its associated permisos_perfil records. Before deleting, the endpoint checks whether any users are assigned to this profile. If any users are found, the operation is rejected with a 409 Conflict error.

This operation is irreversible. The profile record and all its permissions are permanently removed.

Path parameters

number

required

Primary key of the profile to delete.

Response

boolean

required

true when the profile and its permissions are deleted successfully.

string

required

Confirmation string. Always "Perfil eliminado correctamente" on success.

Error responses

Status	Message	Cause
`400`	`ID de perfil inválido`	The `:id` path segment is missing or resolves to `0` or `NaN`.
`409`	`No puedes eliminar este perfil porque hay usuarios que lo están utilizando.`	One or more users in the `usuario` table have `idPerfil` set to this profile’s `id`. Reassign or delete those users first.
`500`	`Ocurrió un error interno al eliminar`	Any other unhandled database error.

Examples

curl --request DELETE \
  --url https://your-domain.com/api/perfil/4 \
  --cookie 'auth_token=<your-jwt>'

const response = await fetch('/api/perfil/4', {
  method: 'DELETE',
  credentials: 'include',
});

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

Success response

200

{
  "success": true,
  "message": "Perfil eliminado correctamente"
}

Error response (409)

409

{
  "statusCode": 409,
  "message": "No puedes eliminar este perfil porque hay usuarios que lo están utilizando."
}

Authentication

Users

Profiles

Modules

Permissions

Path parameters

Response

Error responses

Examples

Success response

Error response (409)

​Path parameters

​Response

​Error responses

​Examples

​Success response

​Error response (409)

Path parameters

Response

Error responses

Examples

Success response

Error response (409)