# namespaces members add

## Synopsis

```shell
omics workbench namespaces members add
  (--email EMAIL | --id USER_ID)
  --role ROLE
  [--namespace NAMESPACE_ID]
```

## Description

Add a user to a namespace with a specified role. The user must already be registered in Workbench. Identify the user by either their email address or user ID.

If the user is already a member of the namespace with the same role, the existing membership is returned. If the user is already a member with a different role, a conflict error is returned.

## Examples

### Add a member by email

```shell
omics workbench namespaces members add --email user@example.com --role ADMIN
```

### Add a member by user ID

```shell
omics workbench namespaces members add --id bcd869ca-8a06-4426-a94d-43f9d91e937d --role ADMIN
```

### Add a member to a specific namespace

```shell
omics workbench namespaces members add \
  --email user@example.com \
  --role ADMIN \
  --namespace bcd869ca-8a06-4426-a94d-43f9d91e937d
```

## Flags:

### `--email`=`EMAIL`

The email address of the user to add. Mutually exclusive with `--id`.

### `--id`=`USER_ID`

The user ID (UUID) of the user to add. Mutually exclusive with `--email`.

### `--role`=`ROLE`

**Required.** The role to assign to the member (e.g. `ADMIN`).

### `--namespace`, `-n`=`NAMESPACE_ID`

The namespace ID. Defaults to the active namespace. The namespace ID can be retrieved from the [namespaces list](https://docs.omics.ai/products/command-line-interface/reference/workbench/namespaces-list) command.