UserService

class UserService

Methods

patch	Update the attributes of a user.
get_coupon_usages	Get all the coupons used for the specified user.
get_transactions	Get all transactions for the specified user.
get	Get the info of the currently logged in user.
login	Login using your username and password.
register	Create a new user.
restrict	Revoke a given token.
logout	Revoke a given token.
search	Search for a user by name and username.

patch(json_body, *, user_id, extra_parameters=None)

Update the attributes of a user.

Parameters:

• json_body (Union[dict, list, PatchUserData]) – The body of the request. See PatchUserData for information about the possible fields. You can provide this data as a PatchUserData or as a dictionary.

• user_id (int) – The id of the user you want to change. Currently this can only be your own user id.

• extra_parameters (Optional[Mapping[str, Union[str, bool, int, float]]]) – The extra query parameters you might want to add. By default no extra query parameters are added.

• self (UserService[AuthenticatedClient]) –

Returns:

The updated user.

Return type:

ExtendedUser

get_coupon_usages(*, user_id, extra_parameters=None)

Get all the coupons used for the specified user.

Parameters:

• user_id (int) – The user to get the coupons used for.

• extra_parameters (Optional[Mapping[str, Union[str, bool, int, float]]]) – The extra query parameters you might want to add. By default no extra query parameters are added.

• self (UserService[AuthenticatedClient]) –

Returns:

All coupons used for the given user.

Return type:

Sequence[TenantCouponUsage | CourseCouponUsage]

get_transactions(*, user_id, extra_parameters=None)

Get all transactions for the specified user.

Parameters:

• user_id (int) – The user to get the transactions for.

• extra_parameters (Optional[Mapping[str, Union[str, bool, int, float]]]) – The extra query parameters you might want to add. By default no extra query parameters are added.

• self (UserService[AuthenticatedClient]) –

Returns:

All transactions for the given user.

Return type:

Sequence[ExtendedTransaction]

get(*, type='default', extended=False, with_permissions=False, extra_parameters=None)

Get the info of the currently logged in user.

Parameters:

• type (Literal['default', 'extended', 'roles']) – If this is roles a mapping between course_id and role name will be returned, if this is extended an ExtendedUser instead of a User will be returned.

• extended (bool) – If true this has the same effect as setting type to extended.

• with_permissions (bool) – Setting this to true will add the key permissions to the user. The value will be a mapping indicating which global permissions this user has.

• extra_parameters (Optional[Mapping[str, Union[str, bool, int, float]]]) – The extra query parameters you might want to add. By default no extra query parameters are added.

• self (UserService[AuthenticatedClient]) –

Returns:

A response containing the JSON serialized user

Return type:

ExtendedUser | User | Mapping[str, str]

login(json_body, *, with_permissions=False, extra_parameters=None)

Login using your username and password.

permissions to the user. The value will be a mapping indicating which global permissions this user has.

Parameters:

• json_body (Union[dict, list, LoginUserData_1, LoginUserData_1_2]) – The body of the request. See LoginUserData for information about the possible fields. You can provide this data as a LoginUserData or as a dictionary.

• with_permissions (bool) – Return the global permissions of the newly logged in user.

• extra_parameters (Optional[Mapping[str, Union[str, bool, int, float]]]) – The extra query parameters you might want to add. By default no extra query parameters are added.

Returns:

A response containing the JSON serialized user

Return type:

UserLoginResponse

register(json_body, *, extra_parameters=None)

Create a new user.

Parameters:

• json_body (Union[dict, list, RegisterUserData]) – The body of the request. See RegisterUserData for information about the possible fields. You can provide this data as a RegisterUserData or as a dictionary.

• extra_parameters (Optional[Mapping[str, Union[str, bool, int, float]]]) – The extra query parameters you might want to add. By default no extra query parameters are added.

Returns:

The registered user and an access_token that can be used to perform requests as this new user.

Return type:

UserLoginResponse

restrict(json_body, *, extra_parameters=None)

Revoke a given token.

Parameters:

• json_body (Union[dict, list, SessionRestrictionData]) – The body of the request. See SessionRestrictionData for information about the possible fields. You can provide this data as a SessionRestrictionData or as a dictionary.

• extra_parameters (Optional[Mapping[str, Union[str, bool, int, float]]]) – The extra query parameters you might want to add. By default no extra query parameters are added.

• self (UserService[AuthenticatedClient]) –

Returns:

An new token that has the given restrictions added.

Return type:

UserLoginResponse

logout(multipart_data, *, extra_parameters=None)

Revoke a given token.

Parameters:

• multipart_data (Union[dict, list, LogoutUserData]) – The data that should form the body of the request. See LogoutUserData for information about the possible fields.

• extra_parameters (Optional[Mapping[str, Union[str, bool, int, float]]]) – The extra query parameters you might want to add. By default no extra query parameters are added.

Returns:

An empty 200 response.

Return type:

LogoutResponse

search(*, q, exclude_course=Nothing, extra_parameters=None)

Search for a user by name and username.

Parameters:

• q (str) – The string to search for, all SQL wildcard are escaped and spaces are replaced by wildcards.

• exclude_course (Union[Just[int], _Nothing[int]]) – Exclude all users that are in the given course from the search results. You need the permission can_list_course_users on this course to use this parameter.

• extra_parameters (Optional[Mapping[str, Union[str, bool, int, float]]]) – The extra query parameters you might want to add. By default no extra query parameters are added.

• self (UserService[AuthenticatedClient]) –

Returns:

The users that match the given query string.

Return type:

Sequence[User]