---
title: "aeontel team"
description: "Manage teams (org-scoped)"
section: "CLI"
group: "Commands"
order: 831
---

## Team commands

### `aeontel team list`

List teams (optionally filter by organization)

```ts
aeontel team list [--organization <orgId>]
```

```bash
aeontel team list
```

### `aeontel team create`

Create a team in an organization

```ts
aeontel team create <organizationId> --name <name> --handle <handle>
```

```bash
aeontel team create org_... --name "My name" --handle <handle>
```

### `aeontel team get`

Get team details

```ts
aeontel team get <id>
```

```bash
aeontel team get id_...
```

### `aeontel team update`

Update team

```ts
aeontel team update <id> [--name <name>] [--handle <handle>]
```

```bash
aeontel team update id_...
```

### `aeontel team delete`

Soft-delete team

```ts
aeontel team delete <id>
```

```bash
aeontel team delete id_...
```

### `aeontel team add-member`

Add a member to a team

```ts
aeontel team add-member <teamId> --user-id <userId> [--role <role>]
```

```bash
aeontel team add-member tea_... --user-id usr_...
```

### `aeontel team get-member`

Get a single team member

```ts
aeontel team get-member <memberId>
```

```bash
aeontel team get-member mem_...
```

### `aeontel team members`

List team members

```ts
aeontel team members <teamId>
```

```bash
aeontel team members tea_...
```

### `aeontel team remove-member`

Remove a team member

```ts
aeontel team remove-member <memberId>
```

```bash
aeontel team remove-member mem_...
```

### `aeontel team restore`

Restore a soft-deleted team

```ts
aeontel team restore <id>
```

```bash
aeontel team restore id_...
```

### `aeontel team update-member`

Update a team member's role

```ts
aeontel team update-member <memberId> --role <role>
```

```bash
aeontel team update-member mem_... --role member
```