From 64cdf3ba77fc4f0d6cba11571869a7927662c52e Mon Sep 17 00:00:00 2001
From: Reingold Shekhtel <raikbitters@gmail.com>
Date: Thu, 10 Oct 2024 12:58:55 +0200
Subject: [PATCH] Refactor users.yaml to add user invitation functionality

---
 api/openapi/apis/users.yaml | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/api/openapi/apis/users.yaml b/api/openapi/apis/users.yaml
index 3d3d3dc..10029dd 100644
--- a/api/openapi/apis/users.yaml
+++ b/api/openapi/apis/users.yaml
@@ -48,6 +48,10 @@ paths:
       description: |-
         Create and send user invitation to email.
 
+        We can create invitations for new users or for existing users.
+
+        We don't update existing users, only assign them to new organizations and projects.
+
         ### Authority
 
         - `ADMINISTRATOR`