Renombrar ID externo

Utiliza este endpoint para renombrar los ID externos de tus usuarios.

Puedes enviar hasta 50 objetos de renombramiento por solicitud.

Este endpoint establece un nuevo external_id (principal) para el usuario y deja obsoleto su external_id existente. Esto significa que se puede identificar al usuario por cualquiera de los dos external_id hasta que se elimine el obsoleto. Tener varios ID externos permite un periodo de migración para que no dejen de funcionar las versiones heredadas de tus aplicaciones que utilizan el esquema de nombres de ID externos anterior. El perfil sigue siendo completamente funcional con ambos identificadores durante la ventana de migración: el SDK de Braze, la REST API y los flujos de mensajería pueden seguir haciendo referencia al usuario por cualquiera de los dos ID hasta que el obsoleto se elimine explícitamente.

Cuando ya no utilices tu antiguo esquema de nombres, te recomendamos encarecidamente que elimines los ID externos obsoletos utilizando el endpoint /users/external_ids/remove.

Advertencia

Asegúrate de eliminar los ID externos obsoletos con el endpoint /users/external_ids/remove en lugar de /users/delete. Enviar una solicitud a /users/delete con el ID externo obsoleto elimina el perfil de usuario por completo y no se puede deshacer.

Puedes descargar el documento OpenAPI y utilizarlo para validar esquemas. Para saber cómo hacerlo, consulta Utilizar esquemas OpenAPI para validar solicitudes.