Supprimer des utilisateurs

Utilisez cet endpoint pour supprimer n’importe quel profil utilisateur en spécifiant un identifiant utilisateur connu.

Une seule requête peut inclure jusqu’à 50 external_ids, user_aliases, braze_ids, email_addresses ou phone_numbers. Une requête ne peut contenir qu’un seul type d’identifiant parmi external_ids, user_aliases, braze_ids, email_addresses ou phone_numbers.

Si votre cas d’usage ne peut pas être résolu par la suppression d’utilisateurs en masse via l’API, contactez l’équipe d’assistance de Braze pour obtenir de l’aide.

Avertissement

La suppression de profils utilisateur est irréversible. Cette action supprime définitivement les utilisateurs, ce qui peut entraîner des écarts dans vos données. Pour en savoir plus, consultez la section Effets de la suppression de profils utilisateur de la référence de cet endpoint.

Résolution des problèmes

Une réponse de succès a été renvoyée, mais l’utilisateur apparaît toujours

Une réponse de succès confirme que la requête a été mise en file d’attente, et non que la suppression est terminée. La suppression s’effectue généralement en moins d’une seconde, mais la propagation de la modification dans l’ensemble des caches peut prendre jusqu’à cinq minutes. Si vous recherchez l’utilisateur dans le tableau de bord ou exportez ses données via l’API immédiatement après, il se peut que des résultats s’affichent encore pendant ce délai de propagation.

Si l’utilisateur existe toujours après plusieurs minutes, vérifiez que l’identifiant indiqué dans votre requête correspond bien au profil réel de l’utilisateur :

• Tableau external_ids : Vérifiez que chaque valeur correspond exactement à l’ID externe d’un utilisateur.
• braze_id : Vous pouvez trouver le braze_id d’un utilisateur en exportant ses données avec l’endpoint /users/export/ids ou en exportant un segment au format CSV (le braze_id y apparaît sous le nom « Appboy ID »).
• Profils avec alias uniquement ou e-mail uniquement : Si le profil n’a pas d’external_id, créez un segment filtrant sur External User ID is blank combiné à l’adresse e-mail ou au numéro de téléphone connu, puis exportez-le au format CSV pour récupérer le braze_id.

Pour vérifier si un utilisateur a bien été supprimé, appelez l’endpoint /users/export/ids avec le même type d’identifiant que celui utilisé dans la requête de suppression (par exemple, en incluant la valeur dans external_ids, braze_id ou user_aliases). Si l’utilisateur n’existe plus, la réponse contient "users": [] et peut inclure "invalid_user_ids" répertoriant cet identifiant.

Vous pouvez télécharger le document OpenAPI et l’utiliser pour valider les schémas. Pour savoir comment procéder, consultez Utiliser les schémas OpenAPI pour valider les requêtes.