Actualizar alias de usuario

Utiliza este punto de conexión 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 actualización de 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 encuentran el alias_label y el old_alias_name dados, entonces el old_alias_name se actualizará al new_alias_name.

Nota

Este punto de conexión no garantiza la secuencia de actualización de los objetos de alias_updates.

Requisitos previos

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

Límite de velocidad

Aplicamos un límite de velocidad compartido de 20 000 solicitudes por minuto a este punto de conexión. Este límite de velocidad se comparte con los puntos finales /users/delete, /users/alias/new, /users/identify y /users/merge, como se documenta en Límites de velocidad 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 del punto de conexión con especificación de objeto de actualización de 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"
    }
  ]
}'