# `src users list`

lists users.

Examples:

  List users:

    	$ src users list

  List users whose names match the query:

    	$ src users list -query='myquery'

  List all users with the "foo" tag:

    	$ src users list -tag=foo

## Usage

```sh
$ src users list [options]
```

## Flags

| Name | Description | Default Value |
|------|-------------|---------------|
| `--dump-requests` | Log GraphQL requests and responses to stdout | `false`|
| `--first` | Returns the first n users from the list. | `1000`|
| `--get-curl` | Print the curl command for executing this query and exit (WARNING: includes printing your access token!) | `false`|
| `--insecure-skip-verify` | Skip validation of TLS certificates against trusted chains | `false`|
| `--query` | Returns users whose names match the query. (e.g. "alice") | ``|
| `--tag` | Returns users with the given tag. | ``|
| `--trace` | Log the trace ID for requests. See https://docs.sourcegraph.com/admin/observability/tracing | `false`|
| `--user-agent-telemetry` | Include the operating system and architecture in the User-Agent sent with requests to Sourcegraph | `true`|
| `-f` | Format for the output, using the syntax of Go package text/template. (e.g. "\{\{.ID\}\}: \{\{.Username\}\} (\{\{.DisplayName\}\})" or "\{\{.\|json\}\}") \| `"\{\{.Username\}\}"`|