Mettre à jour l’alias d’utilisateur

Utilisez cet endpoint pour mettre à jour les alias utilisateur existants.

Vous pouvez spécifier jusqu’à 50 alias de l’utilisateur par requête.

Mettre à jour d’un alias d’utilisateur nécessite que alias_label, old_alias_name et new_alias_name soient compris dans l’objet de mise à jour d’alias d’utilisateur. Si aucun alias d’utilisateur n’est associé au alias_label ni au old_alias_name, aucun alias ne sera mis à jour. Si le alias_label et le old_alias_name sont trouvés, le old_alias_name sera mis à jour vers le new_alias_name.

Conditions préalables

Pour utiliser cet endpoint, vous aurez besoin d’une clé API avec l’autorisation users.alias.update.

Limite de débit

Nous appliquons à cet endpoint une limite de débit partagée de 20 000 requêtes par minute. Cette limitation du débit est partagée avec les endpoints /users/delete, /users/alias/new, /users/identify et /users/merge, comme documenté dans Limites de débit de l’API.

Corps de la demande

1
2
Content-Type: application/json
Authorization: Bearer YOUR_REST_API_KEY

1
2
3
{
  "alias_updates" : (required, array of update user alias object)
}

Paramètres de demande

Corps de demande d’endpoint avec spécification de l’objet de mise à jour d’alias utilisateur

1
2
3
4
5
{
  "alias_label" : (required, string),
  "old_alias_name" : (required, string),
  "new_alias_name" : (required, string)
}

Exemple de demande

1
2
3
4
5
6
7
8
9
10
11
12
curl --location --request POST 'https://rest.iad-01.braze.com/users/alias/update' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_REST_API_KEY' \
--data-raw '{
  "alias_updates" :[
    {
      "alias_label": "example_alias_label",
      "old_alias_name" : "example_old_alias_name",
      "new_alias_name" : "example_new_alias_name"
    }
  ]
}'