From c6aa6385b640f64d55e9ac273de4add22c99e2ba Mon Sep 17 00:00:00 2001
From: Stefan Benz <46600784+stebenz@users.noreply.github.com>
Date: Wed, 7 May 2025 15:59:02 +0200
Subject: [PATCH] docs: add invalid information to member requests (#9858)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

# Which Problems Are Solved

Misleading information on member endpoint requests.

# How the Problems Are Solved

Add comment to member endpoint requests that the request is invalid if
no roles are provided.

# Additional Changes

None

# Additional Context

Closes #9415

Co-authored-by: Fabienne Bühler <fabienne@zitadel.com>
---
 proto/zitadel/management.proto | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/proto/zitadel/management.proto b/proto/zitadel/management.proto
index e69e331f87..84c7823009 100644
--- a/proto/zitadel/management.proto
+++ b/proto/zitadel/management.proto
@@ -9209,7 +9209,7 @@ message AddOrgMemberRequest {
     repeated string roles = 2  [
         (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_field) = {
             example: "[\"ORG_OWNER\"]";
-            description: "If no roles are provided the user won't have any rights"
+            description: "If no roles are provided the user won't have any rights, so the member definition will be regarded as invalid."
         }
     ];
 }
@@ -9222,7 +9222,7 @@ message UpdateOrgMemberRequest {
     repeated string roles = 2 [
         (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_field) = {
             example: "[\"IAM_OWNER\"]";
-            description: "If no roles are provided the user won't have any rights"
+            description: "If no roles are provided the user won't have any rights, so the member definition will be regarded as invalid."
         }
     ];
 }
@@ -9643,7 +9643,7 @@ message AddProjectMemberRequest {
     repeated string roles = 3 [
         (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_field) = {
             example: "[\"PROJECT_OWNER\"]";
-            description: "If no roles are provided the user won't have any rights"
+            description: "If no roles are provided the user won't have any rights, so the member definition will be regarded as invalid."
         }
     ];
 }
@@ -9658,7 +9658,7 @@ message UpdateProjectMemberRequest {
     repeated string roles = 3 [
         (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_field) = {
             example: "[\"PROJECT_OWNER\"]";
-            description: "If no roles are provided the user won't have any rights"
+            description: "If no roles are provided the user won't have any rights, so the member definition will be regarded as invalid."
         }
     ];
 }
@@ -10313,7 +10313,7 @@ message AddProjectGrantMemberRequest {
     repeated string roles = 4 [
         (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_field) = {
             example: "[\"PROJECT_GRANT_OWNER\"]";
-            description: "If no roles are provided the user won't have any rights"
+            description: "If no roles are provided the user won't have any rights, so the member definition will be regarded as invalid."
         }
     ];
 }
@@ -10337,7 +10337,7 @@ message UpdateProjectGrantMemberRequest {
     repeated string roles = 4 [
         (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_field) = {
             example: "[\"PROJECT_GRANT_OWNER\"]";
-            description: "If no roles are provided the user won't have any rights"
+            description: "If no roles are provided the user won't have any rights, so the member definition will be regarded as invalid."
         }
     ];
 }