Home//
REST API Reference
/- Remove an admin
Teammate Office Hours
Activity Log Event Types
Admin
Identify an admin
Set an admin to away
List all activity logs
Search activity logs
List all activity log event types
List all admins
List teammate office hours
Update teammate office hours in bulk
Retrieve teammate office hours
Update teammate office hours
Find an admin by email
Retrieve an admin
Remove an admin
You can remove a single admin (teammate) from your workspace. Requires the remove_admins OAuth scope.
This removes the admin's access to the workspace. In most cases their work is reassigned to the IDs given in the reassign_* parameters. In workspaces with more than one seat type, no reassignment happens if the admin has no seat, a Collaborator seat or a Lite seat.
Security
bearerAuth
Intercom-Versionstring(intercom_version)
Intercom API version.
If you omit the header, the API uses the version set in your app package, and 1.0 if none is set.
Enum:"1.0""1.1""1.2""1.3""1.4""2.0""2.1""2.2""2.3""2.4"
Example:Preview
- The production API serverhttps://api.intercom.io/admins/remove
- The european API serverhttps://api.eu.intercom.io/admins/remove
- The australian API serverhttps://api.au.intercom.io/admins/remove
curl -i -X DELETE \
'https://api.intercom.io/admins/remove?admin_id=123&reassign_messages_admin_id=456&reassign_owner_admin_id=456&reassign_articles_author_id=456&reassign_conversations_admin_id=456&reassign_replies_teams=%7B%22team_id%22%3A789%2C%22assignee_id%22%3A456%7D' \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
-H 'Intercom-Version: Preview'Response
{ "id": "123", "object": "admin", "removed": "true" }