# sdm admin users unassign

```shell
NAME:
   sdm admin users unassign - detach a set of users from a role

USAGE:
   sdm admin users unassign [command options] <role-name> <user-email-1> [user-email-2 user-email-n...]

OPTIONS:
   --template, -t          display a JSON template
   --file value, -f value  load role assignments from JSON file
   --stdin, -i             load from stdin
   --filter value          filter e.g. 'field:name tag:key=value ...'
   --filters-help          show valid filter strings and examples
   --filter-json value     path to JSON based filter
   --timeout value         set time limit for command
```

### Additional Information

The `--template` command produces example `--file` or `--stdin` input:

```json
[
	{
		"roleID": "",
		"roleName": "",
		"users": [
			{
				"id": "a-0000000000000000",
				"email": ""
			}
		]
	}
]
```

Example `--filter-json` file:

```json
[
    {
        "lastName":"S1"
    }
]
```

For more information on the use of filters in the CLI, see the [Filters](https://docs.strongdm.com/references/cli/filters) documentation.
