Delete module

DELETE /api/modulo/:id Permanently removes a module and cascades the deletion to all related records. The endpoint deletes in this order:

All permisos_perfil rows where idModulo matches the given id.
All menu rows where idModulo matches the given id.
The modulo record itself.

This operation is irreversible. The module and all associated permissions and menu entries are permanently removed.

Path parameters

number

required

Primary key of the module to delete.

Response

boolean

required

true when the module and all related records are deleted successfully.

string

required

Confirmation string. Always "Módulo y sus permisos asociados eliminados correctamente." on success.

Error responses

Status	Message	Cause
`200` (with `success: false`)	`ID de módulo inválido.`	The `:id` path segment is missing or resolves to `0` or `NaN`.
`200` (with `success: false`)	`Ocurrió un error al intentar eliminar el módulo.`	Any unhandled database error during the delete sequence.

Errors for this endpoint return HTTP 200 with success: false in the body rather than a 4xx/5xx HTTP status code.

Examples

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

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

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

Success response

200

{
  "success": true,
  "message": "Módulo y sus permisos asociados eliminados correctamente."
}

Error response (invalid ID)

200

{
  "success": false,
  "message": "ID de módulo inválido."
}

Authentication

Users

Profiles

Modules

Permissions

Path parameters

Response

Error responses

Examples

Success response

Error response (invalid ID)

​Path parameters

​Response

​Error responses

​Examples

​Success response

​Error response (invalid ID)

Path parameters

Response

Error responses

Examples

Success response

Error response (invalid ID)