Editar administrador

[ PUT ]

Visión general

Actualiza la información de un administrador sin necesidad de recrear su cuenta. Este proceso es ideal para ajustar roles, actualizar datos de contacto o reasignar grupos cuando cambian las responsabilidades.

• URL: https://sync.airbagtech.io/manager/{MANAGER_ID}
• Compatibilidad: permite modificar atributos individuales sin afectar el historial de actividades.

Autenticación

Requiere el encabezado Authorization: apikey {API_KEY}. Las claves se solicitan a soporte de Airbag Tech y se renuevan periódicamente para mantener un control riguroso de accesos.

Encabezados

Encabezado	Valor	Descripción
Content-Type	application/json	Formato del cuerpo de la solicitud.
Authorization	apikey {API_KEY}	Clave entregada por soporte para autorizar la operación.

Parámetros de ruta

Parámetro	Tipo	Requerido	Descripción
MANAGER_ID	String	Sí	Identificador del administrador a editar. Acepta el ID que tu empresa usó al crearlo o el airbagId. Se envía como parte de la URL.

Cuerpo de la solicitud

{
  "manager": {
    "name": "string",
    "lastName": "string",
    "email": "string",
    "authRole": "string",
    "telephone": "string",
    "birthDate": "string",
    "gender": "string",
    "group": "string"
  }
}

Campos disponibles

Campo	Tipo	Requerido	Descripción
name	String	No	Nombre legal actualizado del administrador. Acepta acentos, minúsculas o mayúsculas combinadas; antes de almacenarse se normaliza automáticamente a mayúsculas y sin acentos.
lastName	String	No	Apellido para reflejar cambios en documentación. Acepta acentos, minúsculas o mayúsculas combinadas; antes de almacenarse se normaliza automáticamente a mayúsculas y sin acentos.
email	String	No	Correo corporativo; actualízalo si cambia el dominio o el puesto.
authRole	String	No	Rol de permisos (admin o group-limited).
telephone	String	No	Teléfono móvil con código de país para notificaciones.
birthDate	String	No	Fecha en formato ISO YYYY-MM-DD si requieres mantener registros internos.
gender	String	No	male, female u other. Campo opcional para segmentaciones internas.
group	String	No	ID del grupo asociado cuando el rol es limitado.

Envía sólo los campos que quieras cambiar.

aviso

Por ahora el campo group se acepta pero no se guarda. Se está corrigiendo; mientras tanto, cambia el grupo desde la plataforma de Airbag.

Normalización de nombres

Los campos name y lastName aceptan valores con acentos, minúsculas o mayúsculas combinadas. Antes de almacenar el registro, Airbag normaliza automáticamente el valor convirtiéndolo a mayúsculas y eliminando acentos. Esta transformación no rechaza la petición ni modifica los datos en el sistema de origen del cliente.

Ejemplo: José Ramírez será almacenado como JOSE RAMIREZ.

Ejemplo de solicitud

curl --location -g --request PUT 'https://sync.airbagtech.io/manager/ADM-001' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: apikey ${API_KEY}' \
  --data '{
    "manager": {
      "name": "Rosa",
      "lastName": "González",
      "email": "[email protected]",
      "authRole": "admin",
      "telephone": "+525555555555",
      "birthDate": "1990-05-01",
      "gender": "female",
      "group": "grupo-central"
    }
  }'

Respuesta

{
  "status": true,
  "manager": {
    "id": "ADM-001",
    "fullName": "ROSA GONZALEZ",
    "airbagId": "ab12cd34ef56gh78ij90kl12mn34op56",
    "company": "Transportes Ejemplo"
  }
}

Campo	Tipo	Descripción
id	String	ID del administrador definido por tu empresa.
fullName	String	Nombre completo ya actualizado.
airbagId	String	Identificador del administrador en Airbag.
company	String	Nombre de la organización.

Respuestas

• 200 OK: datos actualizados; los cambios aplican inmediatamente.
• 400 Solicitud incorrecta: el MANAGER_ID no corresponde a ningún administrador de tu empresa ("Error: Manager not found"), un formato no es válido o el rol no está soportado. La respuesta es {"status": false, "message", "errorId"}.

Procura notificar al usuario cuando haya cambios críticos, como actualizaciones de rol o de correo corporativo.