Skip to main content

# kater admin member remove

Removes a member from your organisation.

{/* Written by apps/landing-page/scripts/docs/write_cli_reference.py from the kater CLI's own help and scripts/docs/cli-reference.md. Do not edit it by hand: change those, then run the script. */}

Kater does not delete their account, and nothing moves.

## Examples

```bash
# Remove a member. Admins alone keep their work, and their schedules pause.
kater admin member remove teammate@example.com
# Give their work and their schedules to another member
kater admin member remove teammate@example.com --to lead@example.com --schedules transfer
```

## Arguments

<div class="cli-options">

| Argument | Description |
| --- | --- |
| `<email>` | The member's email address. |

</div>

## Options

<div class="cli-options">

| Option | Description |
| --- | --- |
| `--to <to>` | The email of the member who receives what they own. They become Manager, with execute, on it, and its checks run as them. Left out, admins alone keep it. |
| `--schedules <schedules>` | pause stops their schedules. transfer moves them to the member named with `--to`. It is `pause` or `transfer`. The default is `pause`. |

</div>

It also takes the [global options](https://kater.ai/docs/cli-reference/global-options/) `--json` and `--help`.

## What happens

- They can no longer sign in to the organisation. When they are in no other organisation, their sessions end.
- The member named with `--to` becomes Manager, with execute, on their personal folders and on what they managed alone, and their apps and dashboards are checked as that member. Without `--to`, only admins can open their folders.
- Their grants, group memberships and attribute values go.
- `--schedules pause`, the default, stops their schedules. `--schedules transfer` moves them to the folder of the member named with `--to`, where they keep sending. `transfer` needs `--to`.
- You cannot remove yourself with it. Use Leave the organization on your profile.

## See also

- [`kater admin member`](https://kater.ai/docs/cli-reference/admin/member/)
- [All commands](https://kater.ai/docs/cli-reference/kater/)

On this page

Examples
Arguments
Options
What happens
See also

Kater CLI Share and administer admin member

kater admin member remove

Removes a member from your organisation.

Kater does not delete their account, and nothing moves.

Examples

# Remove a member. Admins alone keep their work, and their schedules pause.
kater admin member remove teammate@example.com
# Give their work and their schedules to another member
kater admin member remove teammate@example.com --to lead@example.com --schedules transfer

Arguments

Argument	Description
`<email>`	The member’s email address.

Options

Option	Description
`--to <to>`	The email of the member who receives what they own. They become Manager, with execute, on it, and its checks run as them. Left out, admins alone keep it.
`--schedules <schedules>`	pause stops their schedules. transfer moves them to the member named with `--to`. It is `pause` or `transfer`. The default is `pause`.

It also takes the global options --json and --help.

What happens

They can no longer sign in to the organisation. When they are in no other organisation, their sessions end.
The member named with --to becomes Manager, with execute, on their personal folders and on what they managed alone, and their apps and dashboards are checked as that member. Without --to, only admins can open their folders.
Their grants, group memberships and attribute values go.
--schedules pause, the default, stops their schedules. --schedules transfer moves them to the folder of the member named with --to, where they keep sending. transfer needs --to.
You cannot remove yourself with it. Use Leave the organization on your profile.

See also