# 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 and reassigns their
work — auto-messages, ownership, article authorship, and conversation
replies — to the admins named by the `reassign_*` parameters.

Endpoint: DELETE /admins/remove
Version: Preview
Security: bearerAuth

## Query parameters:

  - `admin_id` (integer, required)
    The unique identifier of the admin to remove.

  - `reassign_messages_admin_id` (integer, required)
    The unique identifier of a human admin to reassign the removed admin's auto-message ownership to.

  - `reassign_owner_admin_id` (integer, required)
    The unique identifier of a human admin to reassign the removed admin's ownership (of users and leads) to.

  - `reassign_articles_author_id` (integer, required)
    The unique identifier of a human admin to reassign the removed admin's article authorship to.

  - `reassign_conversations_admin_id` (integer, required)
    The unique identifier of a human admin with Inbox access to reassign the removed admin's conversation replies to. Pass `0` to leave conversations unassigned.

  - `reassign_replies_teams` (array)
    A list of teams and the admin each team's conversation replies should be reassigned to.

## Header parameters:

  - `Intercom-Version` (string)

## Response 200 fields (application/json):

  - `id` (string)
    The unique identifier of the removed admin.
    Example: 123

  - `object` (string)
    Enum: "admin"

  - `removed` (string)
    Whether the admin was removed. Returned as the string `"true"`.
    Enum: "true"

## Response 401 fields (application/json):

  - `type` (string, required)
    The type is error.list
    Example: error.list

  - `request_id` (string)
    Example: f93ecfa8-d08a-4325-8694-89aeb89c8f85

  - `errors` (array, required)
    An array of one or more error objects

  - `errors.code` (string, required)
    A string indicating the kind of error, used to further qualify the HTTP response code
    Example: unauthorized

  - `errors.message` (string)
    Optional. Human readable description of the error.
    Example: Access Token Invalid

  - `errors.field` (string)
    Optional. Used to identify a particular field or query parameter that was in error.
    Example: email

## Response 403 fields (application/json):

  - `type` (string, required)
    The type is error.list
    Example: error.list

  - `request_id` (string)
    Example: f93ecfa8-d08a-4325-8694-89aeb89c8f85

  - `errors` (array, required)
    An array of one or more error objects

  - `errors.code` (string, required)
    A string indicating the kind of error, used to further qualify the HTTP response code
    Example: unauthorized

  - `errors.message` (string)
    Optional. Human readable description of the error.
    Example: Access Token Invalid

  - `errors.field` (string)
    Optional. Used to identify a particular field or query parameter that was in error.
    Example: email

## Response 404 fields (application/json):

  - `type` (string, required)
    The type is error.list
    Example: error.list

  - `request_id` (string)
    Example: f93ecfa8-d08a-4325-8694-89aeb89c8f85

  - `errors` (array, required)
    An array of one or more error objects

  - `errors.code` (string, required)
    A string indicating the kind of error, used to further qualify the HTTP response code
    Example: unauthorized

  - `errors.message` (string)
    Optional. Human readable description of the error.
    Example: Access Token Invalid

  - `errors.field` (string)
    Optional. Used to identify a particular field or query parameter that was in error.
    Example: email

## Response 405 fields (application/json):

  - `type` (string, required)
    The type is error.list
    Example: error.list

  - `request_id` (string)
    Example: f93ecfa8-d08a-4325-8694-89aeb89c8f85

  - `errors` (array, required)
    An array of one or more error objects

  - `errors.code` (string, required)
    A string indicating the kind of error, used to further qualify the HTTP response code
    Example: unauthorized

  - `errors.message` (string)
    Optional. Human readable description of the error.
    Example: Access Token Invalid

  - `errors.field` (string)
    Optional. Used to identify a particular field or query parameter that was in error.
    Example: email