cli+api steps

EdwardAngert · EdwardAngert · commit ad8edd09e6a4 · 2025-05-13T19:10:49.000Z
diff --git a/docs/admin/users/index.md b/docs/admin/users/index.md
@@ -207,31 +207,41 @@ The following filters are supported:
   RFC3339Nano format.
 - `login_type` - Represents the login type of the user. Refer to the [LoginType documentation](https://pkg.go.dev/github.com/coder/coder/v2/codersdk#LoginType) for a list of supported values
 
-## Use the Coder API to retrieve a list of users
+## Retrieve your list of Coder users
 
-Use the [Coder API](../../reference/api/users.md#get-users) to retrieve a full list of users on your Coder deployment:
+<div class="tabs">
+
+You can use the Coder CLI or API to retrieve your list of users.
+
+### CLI
+
+Use `users list` to export the list of users to a CSV file:
 
 ```shell
-curl -X GET http://coder-server:8080/api/v2/users \
-  -H 'Accept: application/json' \
-  -H 'Coder-Session-Token: API_KEY'
+coder users list > users.csv
 ```
 
-You can also filter your results based on the `organization_id` with:
+Visit the [users list](../../reference/cli/users_list.md) documentation for more options.
 
-```shell
-curl -X GET 'http://coder-server:8080/api/v2/users?organization_id=Example-Org' \
+### API
+
+Use [get users](../../reference/api/users.md#get-users):
+
+```bash
+curl -X GET http://coder-server:8080/api/v2/users \
   -H 'Accept: application/json' \
   -H 'Coder-Session-Token: API_KEY'
 ```
 
-### Export a list of users to a CSV file
-
-You can use [jq](https://jqlang.org/) to process the JSON response and export the results to a CSV file:
+To export the results to a CSV file, you can use [jq](https://jqlang.org/) to process the JSON response:
 
-```shell
+```bash
 curl -X GET http://coder-server:8080/api/v2/users \
   -H 'Accept: application/json' \
   -H 'Coder-Session-Token: API_KEY' | \
   jq -r '.users | (map(keys) | add | unique) as $cols | $cols, (.[] | [.[$cols[]]] | @csv)' > users.csv
 ```
+
+Visit the [get users](../../reference/api/users.md#get-users) documentation for more options.
+
+</div>
