Skip to main content

Descripcion General

La API de Eliminacion Masiva de Empleados le permite eliminar varios empleados de su organizacion en una sola solicitud utilizando sus direcciones de correo electronico. Esta API publica esta disenada para que sistemas externos e integraciones gestionen el acceso de empleados sin requerir autenticacion de administrador a traves del flujo JWT estandar. Requiere un Token de Portador de la Organizacion (auth_token) para la autenticacion, asegurando que solo las organizaciones autorizadas puedan eliminar empleados de su espacio de trabajo.

URL de Ruta


Uso de la API

Endpoint:

Encabezados


Cuerpo de la Solicitud


Ejemplo de Solicitud cURL


Codigo de Solicitud de Ejemplo (Node.js con Axios)


Ejemplo de Respuesta (Exitosa)


Campos de Respuesta


Respuestas de Error

401 No Autorizado - Token de Acceso Invalido

400 Solicitud Incorrecta - No Se Proporcionaron Correos

404 No Encontrado - No Se Encontraron Usuarios

500 Error Interno del Servidor


Como Obtener el Token de Autenticacion de la Organizacion

1

Iniciar sesion en EazyBe Workspace

El administrador de la organizacion debe iniciar sesion en EazyBe Workspace con sus credenciales.
2

Localizar el Token de Autenticacion

En la pagina de la Organizacion, se mostrara el Token de Autenticacion de la Organizacion.
3

Copiar y usar el token

El administrador puede copiar el Token de Autenticacion de la Organizacion y pegarlo en la solicitud de la API.

Codigos de Estado de Respuesta


Notas Importantes

Que sucede cuando elimina empleados?
  • Los empleados son eliminados del espacio de trabajo de la organizacion (callyzer_user_details)
  • Su membresia en la organizacion es revocada (callyzer_user_mappings)
  • Los usuarios no son eliminados del sistema por completo - solo se elimina su asociacion con esta organizacion especifica
  • La API procesara todos los correos validos e informara cuales fueron eliminados exitosamente y cuales no fueron encontrados

Exito Parcial

Si algunos correos no se encuentran en el sistema, la API eliminara los empleados que si fueron encontrados y devolvera ambas listas en la respuesta:
  • removedEmails: Empleados eliminados exitosamente
  • notFoundEmails: Correos que no existen en el sistema
Esto le permite manejar fallas parciales de manera elegante y saber exactamente que operaciones tuvieron exito.

Practicas de Higiene

  • Siempre use un Token de Autenticacion de Organizacion valido
  • No comparta ni exponga su token publicamente
  • Verifique las direcciones de correo electronico antes de realizar llamadas a la API para minimizar notFoundEmails
  • Mantenga las credenciales de su organizacion seguras en todo momento
  • Use esta API de manera responsable - los empleados eliminados perderan acceso a los datos de la organizacion
  • Considere implementar un paso de confirmacion en su aplicacion antes de llamar a esta API
  • Almacene la respuesta de la API con fines de auditoria para rastrear quien fue eliminado y cuando

Casos de Uso

  • Automatizacion de Desvinculacion: Elimine automaticamente empleados cuando dejan la empresa
  • Gestion Masiva de Usuarios: Elimine varios empleados a la vez durante reestructuraciones organizacionales
  • Integracion con Sistemas de RRHH: Sincronice eliminaciones de empleados desde su plataforma de RRHH hacia EazyBe
  • Control de Acceso: Revoque rapidamente el acceso de multiples usuarios en situaciones de emergencia
  • Integracion con Sistemas Externos: Permita que sistemas de terceros gestionen el acceso de empleados

Si tiene alguna pregunta o necesita mas ayuda, no dude en contactarnos en hey@eazybe.com.