Actualizar alias de usuario

Utiliza este punto final para actualizar los alias de usuario existentes.

Se pueden especificar hasta 50 alias de usuario por solicitud.

Para actualizar un alias de usuario, es necesario incluir alias_label, old_alias_name y new_alias_name en el objeto de actualizar alias de usuario. Si no hay ningún alias de usuario asociado a alias_label y old_alias_name, no se actualizará ningún alias. Si se encuentra el alias_label y el old_alias_name dados, entonces el old_alias_name se actualizará al new_alias_name.

Requisitos previos

Para utilizar este punto final, necesitarás una clave de API con el permiso users.alias.update.

Límite de velocidad

Para los clientes que se incorporaron a Braze a partir del 16 de septiembre de 2021, aplicamos un límite de velocidad compartido de 20 000 solicitudes por minuto a este punto final. Este límite de velocidad se comparte con los puntos finales /users/delete, /users/identify, /users/merge, y /users/alias/new, como se documenta en Límites de tasa de la API.

Cuerpo de la solicitud

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

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

Parámetros de la solicitud

Cuerpo de la solicitud de punto final con especificación de objeto de actualizar alias de usuario

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

Ejemplo de solicitud

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"
    }
  ]
}'