IOrganizationUserService
Alpha API. Initial API, highly likely to change outside SemVer. Don’t build on it in production.
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) 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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.removeUsersFromUserGroups()methodAlpha
Alpha API. Initial API, highly likely to change outside SemVer. Don’t build on it in production.
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.
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.
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.
Update user group.
updateUserGroup(group: IUserGroup): Promise<void>;
Parameters
Parameter | Type | Description |
|---|---|---|
group | The user group that must be updated. |
Returns
Promise<void>
promise