IOrganizationUserService
Alpha API. Initial API, highly likely to change outside SemVer. Don’t build on it in production. See API maturity.
This service provides access to organization users.
export interface IOrganizationUserService
Methods
Method | Description |
|---|---|
(ALPHA) Add users to multiple user groups. | |
(ALPHA) Creates a new user. | |
(ALPHA) Create user group. | |
(ALPHA) Delete user groups by ID. | |
(ALPHA) Delete users by ID. | |
(ALPHA) Get user by ID. | |
(ALPHA) Get user group by ID. | |
(ALPHA) Get list of users groups. | |
(ALPHA) Get groups assigned to the user. | |
(ALPHA) List user groups. | |
(ALPHA) Get the languages a user set for themselves. | |
(ALPHA) Get list of users. | |
(ALPHA) Get user by email. | |
(ALPHA) Get users assigned to the user group. | |
(ALPHA) List users. | |
(ALPHA) Get list of users with basic information only. This method provides a lightweight alternative to IOrganizationUserService.getUsers() that fetches only basic user information (id, email, name) | |
(ALPHA) Invite a user to the organization. The backend sends the invitation email. | |
(ALPHA) Remove users from user groups. | |
(ALPHA) Set or remove a language a user has for themselves. | |
(ALPHA) Update user. | |
(ALPHA) Update user group. |
Method details
IOrganizationUserService.addUsersToUserGroups()methodAlpha
Alpha API. Initial API, highly likely to change outside SemVer. Don’t build on it in production. See API maturity.
Add users to multiple user groups.
addUsersToUserGroups(userIds: string[], userGroupIds: string[]): Promise<void>;
Parameters
Parameter | Type | Description |
|---|---|---|
userIds | string[] | IDs of the users that will be assigned to user groups. |
userGroupIds | string[] | IDs of the users groups to which user will be assigned. |
Returns
Promise<void>
promise
IOrganizationUserService.createUser()methodAlpha
Alpha API. Initial API, highly likely to change outside SemVer. Don’t build on it in production. See API maturity.
Creates a new user.
createUser(user: IUser): Promise<IUser>;
Parameters
Parameter | Type | Description |
|---|---|---|
user | user to create |
Returns
Promise<IUser>
IOrganizationUserService.createUserGroup()methodAlpha
Alpha API. Initial API, highly likely to change outside SemVer. Don’t build on it in production. See API maturity.
Create user group.
createUserGroup(group: IUserGroup): Promise<void>;
Parameters
Parameter | Type | Description |
|---|---|---|
group | The user group that must be created. |
Returns
Promise<void>
promise
IOrganizationUserService.deleteUserGroups()methodAlpha
Alpha API. Initial API, highly likely to change outside SemVer. Don’t build on it in production. See API maturity.
Delete user groups by ID.
deleteUserGroups(ids: string[]): Promise<void>;
Parameters
Parameter | Type | Description |
|---|---|---|
ids | string[] | ID of the user group. |
Returns
Promise<void>
promise
IOrganizationUserService.deleteUsers()methodAlpha
Alpha API. Initial API, highly likely to change outside SemVer. Don’t build on it in production. See API maturity.
Delete users by ID.
deleteUsers(ids: string[]): Promise<void>;
Parameters
Parameter | Type | Description |
|---|---|---|
ids | string[] | ID of the user. |
Returns
Promise<void>
promise
IOrganizationUserService.getUser()methodAlpha
Alpha API. Initial API, highly likely to change outside SemVer. Don’t build on it in production. See API maturity.
Get user by ID.
getUser(id: string): Promise<IUser | undefined>;
Parameters
Parameter | Type | Description |
|---|---|---|
id | string | ID of the user. |
Returns
Promise<IUser | undefined>
promise
IOrganizationUserService.getUserGroup()methodAlpha
Alpha API. Initial API, highly likely to change outside SemVer. Don’t build on it in production. See API maturity.
Get user group by ID.
getUserGroup(id: string): Promise<IUserGroup | undefined>;
Parameters
Parameter | Type | Description |
|---|---|---|
id | string | ID of the user group. |
Returns
Promise<IUserGroup | undefined>
promise
IOrganizationUserService.getUserGroups()methodAlpha
Alpha API. Initial API, highly likely to change outside SemVer. Don’t build on it in production. See API maturity.
Get list of users groups.
getUserGroups(): Promise<IOrganizationUserGroup[]>;
Returns
Promise<IOrganizationUserGroup[]>
promise
IOrganizationUserService.getUserGroupsOfUser()methodAlpha
Alpha API. Initial API, highly likely to change outside SemVer. Don’t build on it in production. See API maturity.
Get groups assigned to the user.
getUserGroupsOfUser(userId: string): Promise<IUserGroup[]>;
Parameters
Parameter | Type | Description |
|---|---|---|
userId | string | ID of the user. |
Returns
Promise<IUserGroup[]>
promise
IOrganizationUserService.getUserGroupsQuery()methodAlpha
Alpha API. Initial API, highly likely to change outside SemVer. Don’t build on it in production. See API maturity.
List user groups.
getUserGroupsQuery(): IOrganizationUserGroupsQuery;
Returns
promise
IOrganizationUserService.getUserLocalizationSettings()methodAlpha
Alpha API. Initial API, highly likely to change outside SemVer. Don’t build on it in production. See API maturity.
Get the languages a user set for themselves.
getUserLocalizationSettings(userId: string): Promise<IUserLocalizationSettings>;
Parameters
Parameter | Type | Description |
|---|---|---|
userId | string | ID of the user. |
Returns
Promise<IUserLocalizationSettings>
promise with the settings the user has; types the user did not set are missing
IOrganizationUserService.getUsers()methodAlpha
Alpha API. Initial API, highly likely to change outside SemVer. Don’t build on it in production. See API maturity.
Get list of users.
getUsers(): Promise<IOrganizationUser[]>;
Returns
Promise<IOrganizationUser[]>
promise
IOrganizationUserService.getUsersByEmail()methodAlpha
Alpha API. Initial API, highly likely to change outside SemVer. Don’t build on it in production. See API maturity.
Get user by email.
getUsersByEmail(email: string): Promise<IUser[]>;
Parameters
Parameter | Type | Description |
|---|---|---|
string | email of the user. |
Returns
Promise<IUser[]>
promise of array of users
IOrganizationUserService.getUsersOfUserGroup()methodAlpha
Alpha API. Initial API, highly likely to change outside SemVer. Don’t build on it in production. See API maturity.
Get users assigned to the user group.
getUsersOfUserGroup(userGroupId: string): Promise<IUser[]>;
Parameters
Parameter | Type | Description |
|---|---|---|
userGroupId | string | ID of the user group. |
Returns
Promise<IUser[]>
promise
IOrganizationUserService.getUsersQuery()methodAlpha
Alpha API. Initial API, highly likely to change outside SemVer. Don’t build on it in production. See API maturity.
List users.
getUsersQuery(): IOrganizationUsersQuery;
Returns
promise
IOrganizationUserService.getUsersSummary()methodAlpha
Alpha API. Initial API, highly likely to change outside SemVer. Don’t build on it in production. See API maturity.
Get list of users with basic information only.
This method provides a lightweight alternative to IOrganizationUserService.getUsers() that fetches only basic user information (id, email, name)
getUsersSummary(): Promise<IOrganizationUser[]>;
Returns
Promise<IOrganizationUser[]>
promise
IOrganizationUserService.inviteUser()methodAlpha
Alpha API. Initial API, highly likely to change outside SemVer. Don’t build on it in production. See API maturity.
Invite a user to the organization. The backend sends the invitation email.
inviteUser(invitation: IUserInvitation): Promise<void>;
Parameters
Parameter | Type | Description |
|---|---|---|
invitation | details of the invited user |
Returns
Promise<void>
promise that rejects when the backend does not accept the invitation
IOrganizationUserService.removeUsersFromUserGroups()methodAlpha
Alpha API. Initial API, highly likely to change outside SemVer. Don’t build on it in production. See API maturity.
Remove users from user groups.
removeUsersFromUserGroups(userIds: string[], userGroupIds: string[]): Promise<void>;
Parameters
Parameter | Type | Description |
|---|---|---|
userIds | string[] | IDs of the users. |
userGroupIds | string[] | IDs of the user groups. |
Returns
Promise<void>
promise
IOrganizationUserService.setUserLocalizationSetting()methodAlpha
Alpha API. Initial API, highly likely to change outside SemVer. Don’t build on it in production. See API maturity.
Set or remove a language a user has for themselves.
setUserLocalizationSetting(userId: string, type: LocalizationSettingType, value: string | undefined): Promise<void>;
Parameters
Parameter | Type | Description |
|---|---|---|
userId | string | ID of the user. |
type | the language setting to change. | |
value | string | undefined | the language code; |
Returns
Promise<void>
promise
IOrganizationUserService.updateUser()methodAlpha
Alpha API. Initial API, highly likely to change outside SemVer. Don’t build on it in production. See API maturity.
Update user.
updateUser(user: IUser): Promise<void>;
Parameters
Parameter | Type | Description |
|---|---|---|
user | The user that must be updated. |
Returns
Promise<void>
promise
IOrganizationUserService.updateUserGroup()methodAlpha
Alpha API. Initial API, highly likely to change outside SemVer. Don’t build on it in production. See API maturity.
Update user group.
updateUserGroup(group: IUserGroup): Promise<void>;
Parameters
Parameter | Type | Description |
|---|---|---|
group | The user group that must be updated. |
Returns
Promise<void>
promise