Objective

This article explains how to remove users from your Segment workspace using the Delete User API. If users are not removed via the Access Management UI, you can use the Segment APIs to ensure users are deleted and confirm their removal.

Product

Twilio Segment

Environment

Segment Console

User Account Permission/Role(s) Required 

The access token used should have Workspace Owner permission required to access user management APIs.

Procedure 

1. Retrieve User IDs:
   • Use the List Users API to get the current list of users in your workspace.
   • Note the user IDs for the users you wish to remove.
2. Delete Users:
   • Use the Delete User API.
   • Pass the user ID(s) as a query parameter in your request to specify which users to delete.
3. Verify Removal:
   • After deletion, call the List Users API again to confirm the users no longer appear in the workspace.
   • You can also check the workspace audit trail for records of the deletion.

Additional Information 

• All actions performed via API are logged in the workspace audit trail for transparency.
• If users still appear after deletion, contact Segment support or escalate to engineering.