From 0a859fe41677ba11ad1b36d8d9a780f07564c2d4 Mon Sep 17 00:00:00 2001
From: Stefan Benz <46600784+stebenz@users.noreply.github.com>
Date: Fri, 13 Dec 2024 10:33:20 +0100
Subject: [PATCH] docs: correct list users endpoint description (#9050)

# Which Problems Are Solved

There is a wrong description on the ListUsers endpoint on the users v2
API.

# How the Problems Are Solved

Correctly rewrote it with mention of instance instead of organization.

# Additional Changes

None

# Additional Context

Closes #8961
---
 proto/zitadel/user/v2/user_service.proto     | 2 +-
 proto/zitadel/user/v2beta/user_service.proto | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/proto/zitadel/user/v2/user_service.proto b/proto/zitadel/user/v2/user_service.proto
index 47707fef4f..f1b79a9524 100644
--- a/proto/zitadel/user/v2/user_service.proto
+++ b/proto/zitadel/user/v2/user_service.proto
@@ -168,7 +168,7 @@ service UserService {
 
   // Search Users
   //
-  // Search for users. By default, we will return users of your organization. Make sure to include a limit and sorting for pagination..
+  // Search for users. By default, we will return all users of your instance that you have permission to read. Make sure to include a limit and sorting for pagination.
   rpc ListUsers(ListUsersRequest) returns (ListUsersResponse) {
     option (google.api.http) = {
       post: "/v2/users"
diff --git a/proto/zitadel/user/v2beta/user_service.proto b/proto/zitadel/user/v2beta/user_service.proto
index 156f961c59..9ad0a7e6eb 100644
--- a/proto/zitadel/user/v2beta/user_service.proto
+++ b/proto/zitadel/user/v2beta/user_service.proto
@@ -174,7 +174,7 @@ service UserService {
 
   // Search Users
   //
-  // Search for users. By default, we will return users of your organization. Make sure to include a limit and sorting for pagination.
+  // Search for users. By default, we will return all users of your instance that you have permission to read. Make sure to include a limit and sorting for pagination.
   //
   // Deprecated: please move to the corresponding endpoint under user service v2 (GA).
   rpc ListUsers(ListUsersRequest) returns (ListUsersResponse) {