---
title: "corestack_team_member_remove"
url: https://docs.corefinity.com/mcp/tools/corestack_team_member_remove
type: tool
last_updated: 2026-11-13
feature: team
related:
  - https://docs.corefinity.com/api/reference/organisation/delete-team-user.md
  - https://docs.corefinity.com/guides/organisation/people/users-and-invitations.md
---
# corestack_team_member_remove

**Remove a team member.** Remove somebody from your company's team: their account is deleted and they can no longer sign in. Send confirm_email set to their email address, exactly. Scope: write.

- Scope: `write`
- Confirmation: `confirm_email`
- Runs as a task: no

## When to use it

Remove somebody from your company's team: their account is deleted and they can no longer sign in. Ask the person you
act for first, then send `confirm_email` set to the member's email address, exactly. This is the Control Panel's Delete
on Company › Team and `DELETE /api/user/{id}/delete`.

## Inputs

- `user_id` (integer, ≥ 1, required)
- `confirm_email` (string, up to 254 characters, required): the member's email address, exactly as corestack_team_member_get shows it.

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "confirm_email": {
      "description": "The member's email address, exactly.",
      "maxLength": 254,
      "type": "string"
    },
    "user_id": {
      "description": "The team member's id (corestack_team_members_list).",
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "user_id",
    "confirm_email"
  ],
  "type": "object"
}
```

## Refusals

- `confirm_mismatch`: `confirm_email` is not the member's email address; nothing was removed.
- `last_owner`: they are the company's last owner.
- `only_user`: they are the company's only user.
- `privileged_target`: the account is not yours to remove. Only a super administrator may remove a super administrator. A company's owner is removed only by themself, another owner of the same company or Corefinity staff, and the company's primary user only by themself or staff.
- `forbidden`: you may not remove people (an owner, or the delete users permission, may).
- The refusals every tool can answer: `invalid_arguments`, `tenant_mismatch`, `scope_required`, `pin_refused`, `rate_limited`, `temporarily_unavailable`, `internal_error` (corestack://guides/how-this-server-works).

## Example

```json
{
  "name": "corestack_team_member_remove",
  "arguments": {
    "user_id": 1042,
    "confirm_email": "sam@example.com"
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_team_member_remove with user_id 1042. (Remove a team member.) Tell me what it returned.
```

## The same task elsewhere

- Endpoint: [DELETE /api/user/{id}/delete](https://docs.corefinity.com/api/reference/organisation/delete-team-user.md)
- Guide: [Users and invitations](https://docs.corefinity.com/guides/organisation/people/users-and-invitations.md)
