diff --git a/api/v4/source/teams.yaml b/api/v4/source/teams.yaml
index 165ebf194ec..cf5ab8266cd 100644
--- a/api/v4/source/teams.yaml
+++ b/api/v4/source/teams.yaml
@@ -1405,14 +1405,58 @@
required: true
schema:
type: string
+ - name: graceful
+ in: query
+ description: When provided with a non-empty value, returns an array with both successful invites and errors instead of aborting on the first error. Required when using `profiles`.
+ required: false
+ schema:
+ type: boolean
requestBody:
content:
application/json:
schema:
- type: array
- items:
- type: string
- description: List of user's email
+ oneOf:
+ - type: array
+ items:
+ type: string
+ - type: object
+ required:
+ - emails
+ properties:
+ emails:
+ type: array
+ items:
+ type: string
+ description: List of user's email
+ channelIds:
+ type: array
+ items:
+ type: string
+ description: List of channel IDs to invite the users to
+ message:
+ type: string
+ description: Custom message included in the invitation email
+ profiles:
+ type: array
+ description: |
+ Profile fields to pre-set on the accounts created from these invitations. Each entry must reference an email present in `emails`. Requires a non-empty `graceful` query parameter, an Enterprise license, and locked profile fields to be enabled.
+
+ __Minimum server version__: 11.11
+ items:
+ type: object
+ required:
+ - email
+ - username
+ properties:
+ email:
+ type: string
+ username:
+ type: string
+ first_name:
+ type: string
+ last_name:
+ type: string
+ description: List of user's email, or an object with emails and invitation options
required: true
responses:
"200":
diff --git a/docs/main/administration-guide/configure/site-configuration-settings.mdx b/docs/main/administration-guide/configure/site-configuration-settings.mdx
index 597f13e5205..3150bd2bbd3 100644
--- a/docs/main/administration-guide/configure/site-configuration-settings.mdx
+++ b/docs/main/administration-guide/configure/site-configuration-settings.mdx
@@ -758,6 +758,23 @@ Access the following configuration settings in the System Console by going to **
+### Lock profile fields for email users
+
+
This setting controls whether users who sign in with email and password can change their own profile fields under Settings > Profile. System admins are always exempt and can edit any user's profile through the System Console or the API. Users authenticating through an external provider (AD/LDAP, SAML, or OAuth) aren't affected; their fields remain governed by the provider's attribute settings.
Empty first and last names can be filled in once by the user, so people who join through a team invite link or open server signup aren't left without a name. Once set, the name is locked. When this setting is enabled, anyone with the Invite Users permission can pre-set the first name, last name, and username for each email invitation they send. The invited person sees the pre-set username on the account creation page and cannot change it. We recommend restricting the Invite Users permission through advanced permissions to people trusted to enter this information correctly. For a display name convention of "First Last" across the workspace, combine this setting with Teammate Name Display set to Show first and last name and Lock Teammate Name Display set to true. |
+
|
+