Remove external ID

Use this endpoint to remove your users’ old deprecated external IDs.

You can send up to 50 external IDs per request.

Prerequisites

To use this endpoint, you’ll need an API key with the users.external_ids.remove permission.

Rate limit

We apply a rate limit of 1,000 requests per minute to this endpoint, as documented in API rate limits.

Request body

1
2
Content-Type: application/json
Authorization: Bearer YOUR-REST-API-KEY

1
2
3
{
  "external_ids" : (required, array of external identifiers to remove)
}

Request parameters

Request example

1
2
3
4
5
6
7
8
9
curl --location --request POST 'https://rest.iad-01.braze.com/users/external_ids/remove' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-REST-API-KEY' \
--data-raw '{
  "external_ids" :[
    "existing_deprecated_external_id_string",
    ...
  ]
}'

Response

The response will confirm all successful removals, as well as unsuccessful removals with the associated errors. Error messages in the removal_errors field will reference the index in the array of the original request.

1
2
3
4
5
{
  "message" : (string) status message,
  "removed_ids" : (array of strings) successful remove operations,
  "removal_errors": (array of arrays) <minor error message>
}

The message field will return success for any valid request. More specific errors are captured in the removal_errors array. The message field returns an error in the case of:

• Invalid API key
• Empty external_ids array
• external_ids array with more than 50 items
• Rate limit hit (more than 1,000 requests/minute)