Endpoints / Configuración
Eliminar configuración
Elimina permanentemente una configuración identificada por su clave y empresa, desde administración central.
/configs/:configKeyCaso de Uso
Se usa cuando un administrador necesita remover por completo una clave de configuración de una empresa, por ejemplo para limpiar claves obsoletas o eliminar configuraciones erróneas. Al usarlo, el usuario obtiene la confirmación con la clave eliminada.
Autenticación
Requiere token JWT en el header `Authorization: Bearer <token>`. Solo permite acceso a usuarios con rol administrador. La empresa del usuario autenticado debe estar activa y ser empresa padre.
Parámetros de ruta
configKeystringobligatorioClave de configuración a eliminar.
Query params
companyIdstringobligatorioIdentificador de la empresa donde se eliminará la clave.
Body
No aplica.
Reglas de negocio
Solo un usuario con rol administrador puede eliminar configuraciones.
La empresa del usuario autenticado debe ser empresa padre.
La empresa del usuario autenticado debe estar activa.
El usuario autenticado debe estar activo.
configKey y companyId son obligatorios.
La eliminación se realiza por la combinación de companyId y configKey.
La eliminación es permanente; la configuración no puede recuperarse.
La respuesta solo devuelve la clave eliminada, no el objeto completo.
Errores esperados
No se envió un token JWT válido o el token no contiene información válida del usuario.
No se envió el parámetro configKey en la ruta.
No se envió el query param companyId.
No existe una configuración con la combinación de companyId y configKey indicada.
La empresa asociada al usuario autenticado no fue encontrada.
La empresa asociada al usuario autenticado está inactiva.
El usuario autenticado no fue encontrado dentro de su empresa.
El usuario autenticado no pertenece a la empresa indicada por su sesión.
El usuario autenticado no tiene el rol requerido para eliminar configuraciones.
El usuario autenticado está inactivo y no puede usar el sistema.
La empresa del usuario autenticado no es empresa padre.
Notas de uso
Este endpoint no recibe body.
companyId se envía como query param en la URL.
La eliminación es permanente; no se conserva respaldo de la configuración eliminada.
La respuesta devuelve solo cfclave, no el objeto eliminado completo.