> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.neetokb.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Team members

> List, view, invite, update, and remove team members.

A team member is a user in your workspace. For fields and response details, see the [API reference](/api-reference/team-members/list).

Samples on this page show the `--json` envelope, which stays stable across terminals; the default pretty output picks columns to fit your terminal width. See [Output formats](/cli/output-formats).

## List team members

This command shows the team members in your workspace. Use this when you want to see who already has access before inviting or removing someone, or to look up a member's ID.

```bash theme={"system"}
neetokb team-members list
neetokb team-members list --email oliver@example.com
```

| Flag          | Type     | Required | Default | Description              |
| ------------- | -------- | -------- | ------- | ------------------------ |
| `--email`     | `string` |          |         | Filter by email          |
| `--page`      | `int`    |          | `0`     | Page number              |
| `--page-size` | `int`    |          | `0`     | Items per page (max 100) |

```json Sample output (--json) theme={"system"}
{
  "data": [
    {
      "id": "aaaabbbb-cccc-dddd-eeee-ffff00001111",
      "email": "oliver@example.com",
      "first_name": "Oliver",
      "last_name": "Smith",
      "time_zone": "Asia/Kolkata",
      "profile_image_url": null,
      "active": true,
      "organization_role": "Admin"
    }
  ],
  "breadcrumbs": [
    { "label": "Show", "command": "neetokb team-members show <id>" },
    { "label": "Update", "command": "neetokb team-members update <id>" },
    { "label": "Remove", "command": "neetokb team-members delete <id>" }
  ],
  "pagination": {
    "total_records": 1,
    "total_pages": 1,
    "current_page_number": 1,
    "page_size": 30
  }
}
```

`--email` matches an address exactly; it does not search by partial address.

## Show a team member

This command shows details for one team member ID. Use this when you want to inspect a member's email, role, time zone, and active status after finding their ID from `team-members list`.

```bash theme={"system"}
neetokb team-members show aaaabbbb-cccc-dddd-eeee-ffff00001111
```

**Required arguments:**

* `<id>` - Team member UUID

```json Sample output (--json) theme={"system"}
{
  "data": {
    "team_member": {
      "id": "aaaabbbb-cccc-dddd-eeee-ffff00001111",
      "email": "oliver@example.com",
      "first_name": "Oliver",
      "last_name": "Smith",
      "time_zone": "Asia/Kolkata",
      "profile_image_url": null,
      "active": true,
      "organization_role": "Admin"
    }
  }
}
```

## Invite team members

This command invites team members to your workspace. Use this when you want to add colleagues by email and assign an organization role without opening the Team Members page in NeetoKB.

```bash theme={"system"}
neetokb team-members create \
  --emails oliver@example.com,sam@example.com \
  --role Standard
```

| Flag            | Type          | Required | Default | Description                                 |
| --------------- | ------------- | -------- | ------- | ------------------------------------------- |
| `--emails`      | `stringSlice` | Yes      | `[]`    | Email addresses to invite (comma-separated) |
| `--role`        | `string`      | Yes      |         | Organization role                           |
| `--send-invite` | `bool`        |          | `true`  | Send invitation email                       |

Invites one or more people in a single call. `--emails` takes a comma-separated list, and both it and `--role` are required. `--role` must name a role that already exists under **Settings → Roles**. Pass `--send-invite=false` to add them without sending an invitation email.

```json Sample output (--json) theme={"system"}
{
  "data": {
    "message": "Users added successfully"
  },
  "breadcrumbs": [
    { "label": "List team members", "command": "neetokb team-members list" }
  ]
}
```

The response confirms the request; it does not include a team member record. List the members afterwards to retrieve it.

## Update a team member

This command updates a team member's profile or role. Use this when correcting names, email, time zone, or organization role.

```bash theme={"system"}
neetokb team-members update aaaabbbb-cccc-dddd-eeee-ffff00001111 \
  --first-name Oliver --role Admin
```

**Required arguments:**

* `<id>` - Team member UUID

| Flag           | Type     | Required | Default | Description       |
| -------------- | -------- | -------- | ------- | ----------------- |
| `--email`      | `string` |          |         | New email address |
| `--first-name` | `string` |          |         | First name        |
| `--last-name`  | `string` |          |         | Last name         |
| `--role`       | `string` |          |         | Organization role |
| `--time-zone`  | `string` |          |         | Time zone         |

Only the flags you pass are changed. `--role` must name a role that already exists in the workspace.

```json Sample output (--json) theme={"system"}
{
  "data": {
    "team_member": {
      "id": "aaaabbbb-cccc-dddd-eeee-ffff00001111",
      "email": "oliver@example.com",
      "first_name": "Oliver",
      "last_name": "Smith",
      "time_zone": "Asia/Kolkata",
      "profile_image_url": null,
      "active": true,
      "organization_role": "Admin"
    }
  }
}
```

## Remove a team member

This command removes a team member from your workspace. Use this when someone should no longer have access.

```bash theme={"system"}
neetokb team-members delete aaaabbbb-cccc-dddd-eeee-ffff00001111
```

**Required arguments:**

* `<id>` - Team member UUID

```text Sample output theme={"system"}
Team member removed.
```

With `--quiet`, this prints `success`.