Network user settings resources

Get user settings

GET /settings/user

Response

{
  "fullname_reversed": false,
  "use_formal_language": false,
  "appendix_user_search_clip": [
    "email"
  ],
  "user_custom_fields": [
    "sip"
  ],
  "anonymize_deleted_users": true,
  "allow_inactive_user_interaction": false,
  "appendix_user_info_clip": [
    "email",
    "department"
  ],
  "user_creation_default_roles": [
    "user"
  ],
  "invitation_email_allowed_domains": []
}


Update user settings

PUT /settings/user

Note: If a setting key is omitted the setting is ignored. If the value for a setting is set to null the respective setting is reset to its default value.

Parameter Type Default Description
use_formal_language boolean false If set to true users are addressed using their first and lastname otherwise only the firstname is used.
fullname_reversed boolean false If enabled user names are displayed in reverse order (lastname firstname)
anonymize_deleted_users boolean true See: Anonymization of deleted users
anonymize_users_email boolean false See: Email Anonymization
allow_inactive_user_interaction boolean true If enabled inactive users will shown up in the search for mentioning, sharing and recommending and receive corresponding notfications.
user_custom_fields Array [] Defines all allowed customfields on the user resource.
appendix_user_info_clip Array ["position", "department", "location"] Configurable user properties which are shown together with the username in all user related content.
Supported values are: score_level, email, position, company, department, location, country, about
appendix_user_search_clip Array ["email"] Configurable user properties clip which are shown together with the username in all user search results.
Supported values are: score_level, email, position, company, department, location, country, about
user_creation_default_roles Array ["user", "manager"] Defines the user roles which are automatically assigned to a newly created user. Only unprivileged roles are allowed.
invitation_email_allowed_domains Array [] Sending external invitation emails (invite to network, share question & solution, recommend expert) to external email addresses is restricted to the domains specified here. If the list doesn't contain any domains, it is allowed to send emails to any email address (unrestricted is default).

Response

{
  "fullname_reversed": false,
  "use_formal_language": false,
  "appendix_user_search_clip": [
    "email"
  ],
  "user_custom_fields": [
    "sip"
  ],
  "anonymize_deleted_users": true,
  "allow_inactive_user_interaction": false,
  "appendix_user_info_clip": [
    "email",
    "department"
  ],
  "user_creation_default_roles": [
    "user",
    "manager"
  ],
  "invitation_email_allowed_domains": []
}