@@ -59,7 +59,17 @@ The API returns an error if you try to delete:
5959- All ` user_id ` values from a profile. Profiles must have at least one ` user_id ` .
6060- A ` group_id ` identifier. The API only supports individual profiles.
6161
62- ### API request format
62+ ### Authentication
63+
64+ The API uses HTTP Basic Authentication. Base64-encode your access token with a trailing colon (the colon represents an empty password):
65+
66+ ``` bash
67+ echo -n ' your_token:' | base64
68+ ```
69+
70+ Use the encoded value in the ` Authorization ` header of your requests. Generate your access token in ** Unify > Unify settings > API access** .
71+
72+ ### Request format
6373
6474The API accepts one identifier per request.
6575
@@ -75,20 +85,19 @@ Replace the following parameters in the URL:
7585| --------------- | ---------------------------------------------------------------------------------------------------- |
7686| ` HOST_NAME ` | ` profiles.segment.com ` for North America workspaces or ` profiles.euw1.segment.com ` for EU workspaces |
7787| ` SPACE_ID ` | Your space ID. Find this in ** Unify > Unify settings > API access** . |
78- | ` USER_ID_VALUE ` | The ` user_id ` value that identifies the profile. |
79- | ` AUTH_TOKEN ` | Your access token. Generate this in ** Unify > Unify settings > API access** . |
88+ | ` USER_ID_VALUE ` | The ` user_id ` value that identifies the profile. |
8089
8190Include these fields in the request body:
8291
8392| Field | Description |
8493| --------------------- | ------------------------------------------------------------------------------ |
8594| ` delete_external_ids ` | Array containing the identifier to delete. Limit: 1 identifier per request |
86- | ` id ` | Value of the identifier to delete (for example, ` hello@gmail .com ` ) |
95+ | ` id ` | Value of the identifier to delete (for example, ` hello@example .com ` ) |
8796| ` type ` | Type of identifier to delete (for example, ` email ` , ` anonymous_id ` , ` user_id ` ) |
8897
8998### Example request
9099
91- First, base64 -encode your access token with a trailing colon:
100+ The API uses HTTP Basic Authentication. Base64 -encode your access token with a trailing colon (the colon represents an empty password) :
92101
93102``` bash
94103echo -n ' your_token:' | base64
0 commit comments