docs(iam): create user spec (scaleway#933)

Co-authored-by: Laure-di <[email protected]>

Author: scaleway-bot

scaleway-async/scaleway_async/iam/v1alpha1/api.py

@@ -582,7 +582,7 @@ async def create_user(
     ) -> User:
         """
         Create a new user.
-        Create a new user. You must define the `organization_id` and the `email` in your request.
+        Create a new user. You must define the `organization_id` in your request. If you are adding a member, enter the member's details. If you are adding a guest, you must define the `email` and not add the member attribute.
         :param organization_id: ID of the Organization.
         :param email: Email of the user.
         One-Of ('type'): at most one of 'email', 'member' could be set.

scaleway/scaleway/iam/v1alpha1/api.py

@@ -582,7 +582,7 @@ def create_user(
     ) -> User:
         """
         Create a new user.
-        Create a new user. You must define the `organization_id` and the `email` in your request.
+        Create a new user. You must define the `organization_id` in your request. If you are adding a member, enter the member's details. If you are adding a guest, you must define the `email` and not add the member attribute.
         :param organization_id: ID of the Organization.
         :param email: Email of the user.
         One-Of ('type'): at most one of 'email', 'member' could be set.