Skip to content

ENG-2805: generated code for client libraries #47

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Jul 18, 2025
Merged

ENG-2805: generated code for client libraries #47

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
96 changes: 48 additions & 48 deletions src/main/python/fusionauth/fusionauth_client.py
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
#
# Copyright (c) 2018-2023, FusionAuth, All Rights Reserved
# Copyright (c) 2018-2025, FusionAuth, All Rights Reserved
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
Expand Down Expand Up @@ -748,7 +748,7 @@ def deactivate_user_action(self, user_action_id):
@deprecated("This method has been renamed to deactivate_users_by_ids, use that method instead.")
def deactivate_users(self, user_ids):
"""
Deactivates the users with the given ids.
Deactivates the users with the given Ids.

Attributes:
user_ids: The ids of the users to deactivate.
Expand All @@ -762,7 +762,7 @@ def deactivate_users(self, user_ids):

def deactivate_users_by_ids(self, user_ids):
"""
Deactivates the users with the given ids.
Deactivates the users with the given Ids.

Attributes:
user_ids: The ids of the users to deactivate.
Expand Down Expand Up @@ -1205,8 +1205,8 @@ def delete_user_with_request(self, user_id, request):
@deprecated("This method has been renamed to delete_users_by_query, use that method instead.")
def delete_users(self, request):
"""
Deletes the users with the given ids, or users matching the provided JSON query or queryString.
The order of preference is ids, query and then queryString, it is recommended to only provide one of the three for the request.
Deletes the users with the given Ids, or users matching the provided JSON query or queryString.
The order of preference is Ids, query and then queryString, it is recommended to only provide one of the three for the request.

This method can be used to deactivate or permanently delete (hard-delete) users based upon the hardDelete boolean in the request body.
Using the dryRun parameter you may also request the result of the action without actually deleting or deactivating any users.
Expand All @@ -1221,8 +1221,8 @@ def delete_users(self, request):

def delete_users_by_query(self, request):
"""
Deletes the users with the given ids, or users matching the provided JSON query or queryString.
The order of preference is ids, query and then queryString, it is recommended to only provide one of the three for the request.
Deletes the users with the given Ids, or users matching the provided JSON query or queryString.
The order of preference is Ids, query and then queryString, it is recommended to only provide one of the three for the request.

This method can be used to deactivate or permanently delete (hard-delete) users based upon the hardDelete boolean in the request body.
Using the dryRun parameter you may also request the result of the action without actually deleting or deactivating any users.
Expand Down Expand Up @@ -1744,7 +1744,7 @@ def modify_action(self, action_id, request):
action.

Attributes:
action_id: The Id of the action to modify. This is technically the user action log id.
action_id: The Id of the action to modify. This is technically the user action log Id.
request: The request that contains all the information about the modification.
"""
return self.start().uri('/api/user/action') \
Expand All @@ -1767,16 +1767,16 @@ def passwordless_login(self, request):

def patch_api_key(self, key_id, request):
"""
Updates an authentication API key by given id
Updates an API key with the given Id.

Attributes:
key_id: The Id of the authentication key. If not provided a secure random api key will be generated.
request: The request object that contains all the information needed to create the APIKey.
key_id: The Id of the API key. If not provided a secure random api key will be generated.
request: The request object that contains all the information needed to create the API key.
"""
return self.start().uri('/api/api-key') \
.url_segment(key_id) \
.body_handler(JSONBodyHandler(request)) \
.post() \
.patch() \
.go()

def patch_application(self, application_id, request):
Expand Down Expand Up @@ -2285,7 +2285,7 @@ def reindex(self, request):

def remove_user_from_family(self, family_id, user_id):
"""
Removes a user from the family with the given id.
Removes a user from the family with the given Id.

Attributes:
family_id: The Id of the family to remove the user from.
Expand Down Expand Up @@ -2340,7 +2340,7 @@ def resend_registration_verification(self, email, application_id):

def retrieve_api_key(self, key_id):
"""
Retrieves an authentication API key for the given id
Retrieves an authentication API key for the given Id.

Attributes:
key_id: The Id of the API key to retrieve.
Expand Down Expand Up @@ -2407,7 +2407,7 @@ def retrieve_application(self, application_id=None):
Retrieves the application for the given Id or all the applications if the Id is null.

Attributes:
application_id: (Optional) The application id.
application_id: (Optional) The application Id.
"""
return self.start().uri('/api/application') \
.url_segment(application_id) \
Expand Down Expand Up @@ -2482,11 +2482,11 @@ def retrieve_consents(self):

def retrieve_daily_active_report(self, start, end, application_id=None):
"""
Retrieves the daily active user report between the two instants. If you specify an application id, it will only
Retrieves the daily active user report between the two instants. If you specify an application Id, it will only
return the daily active counts for that application.

Attributes:
application_id: (Optional) The application id.
application_id: (Optional) The application Id.
start: The start instant as UTC milliseconds since Epoch.
end: The end instant as UTC milliseconds since Epoch.
"""
Expand All @@ -2499,7 +2499,7 @@ def retrieve_daily_active_report(self, start, end, application_id=None):

def retrieve_email_template(self, email_template_id=None):
"""
Retrieves the email template for the given Id. If you don't specify the id, this will return all the email templates.
Retrieves the email template for the given Id. If you don't specify the Id, this will return all the email templates.

Attributes:
email_template_id: (Optional) The Id of the email template.
Expand Down Expand Up @@ -2882,11 +2882,11 @@ def retrieve_lambdas_by_type(self, _type):

def retrieve_login_report(self, start, end, application_id=None):
"""
Retrieves the login report between the two instants. If you specify an application id, it will only return the
Retrieves the login report between the two instants. If you specify an application Id, it will only return the
login counts for that application.

Attributes:
application_id: (Optional) The application id.
application_id: (Optional) The application Id.
start: The start instant as UTC milliseconds since Epoch.
end: The end instant as UTC milliseconds since Epoch.
"""
Expand All @@ -2899,7 +2899,7 @@ def retrieve_login_report(self, start, end, application_id=None):

def retrieve_message_template(self, message_template_id=None):
"""
Retrieves the message template for the given Id. If you don't specify the id, this will return all the message templates.
Retrieves the message template for the given Id. If you don't specify the Id, this will return all the message templates.

Attributes:
message_template_id: (Optional) The Id of the message template.
Expand Down Expand Up @@ -2955,11 +2955,11 @@ def retrieve_messengers(self):

def retrieve_monthly_active_report(self, start, end, application_id=None):
"""
Retrieves the monthly active user report between the two instants. If you specify an application id, it will only
Retrieves the monthly active user report between the two instants. If you specify an application Id, it will only
return the monthly active counts for that application.

Attributes:
application_id: (Optional) The application id.
application_id: (Optional) The application Id.
start: The start instant as UTC milliseconds since Epoch.
end: The end instant as UTC milliseconds since Epoch.
"""
Expand Down Expand Up @@ -3121,7 +3121,7 @@ def retrieve_refresh_tokens(self, user_id):

def retrieve_registration(self, user_id, application_id):
"""
Retrieves the user registration for the user with the given Id and the given application id.
Retrieves the user registration for the user with the given Id and the given application Id.

Attributes:
user_id: The Id of the user.
Expand All @@ -3135,11 +3135,11 @@ def retrieve_registration(self, user_id, application_id):

def retrieve_registration_report(self, start, end, application_id=None):
"""
Retrieves the registration report between the two instants. If you specify an application id, it will only return
Retrieves the registration report between the two instants. If you specify an application Id, it will only return
the registration counts for that application.

Attributes:
application_id: (Optional) The application id.
application_id: (Optional) The application Id.
start: The start instant as UTC milliseconds since Epoch.
end: The end instant as UTC milliseconds since Epoch.
"""
Expand Down Expand Up @@ -3301,7 +3301,7 @@ def retrieve_user(self, user_id):

def retrieve_user_action(self, user_action_id=None):
"""
Retrieves the user action for the given Id. If you pass in null for the id, this will return all the user
Retrieves the user action for the given Id. If you pass in null for the Id, this will return all the user
actions.

Attributes:
Expand All @@ -3314,7 +3314,7 @@ def retrieve_user_action(self, user_action_id=None):

def retrieve_user_action_reason(self, user_action_reason_id=None):
"""
Retrieves the user action reason for the given Id. If you pass in null for the id, this will return all the user
Retrieves the user action reason for the given Id. If you pass in null for the Id, this will return all the user
action reasons.

Attributes:
Expand Down Expand Up @@ -3414,8 +3414,8 @@ def retrieve_user_code(self, client_id, client_secret, user_code):
This API is useful if you want to build your own login workflow to complete a device grant.

Attributes:
client_id: The client id.
client_secret: The client id.
client_id: The client Id.
client_secret: The client Id.
user_code: The end-user verification code.
"""
body = {
Expand Down Expand Up @@ -3527,12 +3527,12 @@ def retrieve_user_links_by_user_id(self, user_id, identity_provider_id=None):

def retrieve_user_login_report(self, user_id, start, end, application_id=None):
"""
Retrieves the login report between the two instants for a particular user by Id. If you specify an application id, it will only return the
Retrieves the login report between the two instants for a particular user by Id. If you specify an application Id, it will only return the
login counts for that application.

Attributes:
application_id: (Optional) The application id.
user_id: The userId id.
application_id: (Optional) The application Id.
user_id: The userId Id.
start: The start instant as UTC milliseconds since Epoch.
end: The end instant as UTC milliseconds since Epoch.
"""
Expand All @@ -3546,12 +3546,12 @@ def retrieve_user_login_report(self, user_id, start, end, application_id=None):

def retrieve_user_login_report_by_login_id(self, login_id, start, end, application_id=None):
"""
Retrieves the login report between the two instants for a particular user by login Id. If you specify an application id, it will only return the
Retrieves the login report between the two instants for a particular user by login Id. If you specify an application Id, it will only return the
login counts for that application.

Attributes:
application_id: (Optional) The application id.
login_id: The userId id.
application_id: (Optional) The application Id.
login_id: The userId Id.
start: The start instant as UTC milliseconds since Epoch.
end: The end instant as UTC milliseconds since Epoch.
"""
Expand Down Expand Up @@ -3627,7 +3627,7 @@ def retrieve_web_authn_credentials_for_user(self, user_id):

def retrieve_webhook(self, webhook_id=None):
"""
Retrieves the webhook for the given Id. If you pass in null for the id, this will return all the webhooks.
Retrieves the webhook for the given Id. If you pass in null for the Id, this will return all the webhooks.

Attributes:
webhook_id: (Optional) The Id of the webhook.
Expand Down Expand Up @@ -3859,7 +3859,7 @@ def search_entities(self, request):

def search_entities_by_ids(self, ids):
"""
Retrieves the entities for the given ids. If any Id is invalid, it is ignored.
Retrieves the entities for the given Ids. If any Id is invalid, it is ignored.

Attributes:
ids: The entity ids to search for.
Expand Down Expand Up @@ -4028,7 +4028,7 @@ def search_user_comments(self, request):
@deprecated("This method has been renamed to search_users_by_ids, use that method instead.")
def search_users(self, ids):
"""
Retrieves the users for the given ids. If any Id is invalid, it is ignored.
Retrieves the users for the given Ids. If any Id is invalid, it is ignored.

Attributes:
ids: The user ids to search for.
Expand All @@ -4040,10 +4040,10 @@ def search_users(self, ids):

def search_users_by_ids(self, ids):
"""
Retrieves the users for the given ids. If any Id is invalid, it is ignored.
Retrieves the users for the given Ids. If any Id is invalid, it is ignored.

Attributes:
ids: The user ids to search for.
ids: The user Ids to search for.
"""
return self.start().uri('/api/user/search') \
.url_parameter('ids', self.convert_true_false(ids)) \
Expand Down Expand Up @@ -4103,7 +4103,7 @@ def search_webhooks(self, request):

def send_email(self, email_template_id, request):
"""
Send an email using an email template id. You can optionally provide <code>requestData</code> to access key value
Send an email using an email template Id. You can optionally provide <code>requestData</code> to access key value
pairs in the email template.

Attributes:
Expand Down Expand Up @@ -4271,16 +4271,16 @@ def two_factor_login(self, request):
.post() \
.go()

def update_api_key(self, api_key_id, request):
def update_api_key(self, key_id, request):
"""
Updates an API key by given id
Updates an API key with the given Id.

Attributes:
api_key_id: The Id of the API key to update.
request: The request object that contains all the information used to create the API Key.
key_id: The Id of the API key to update.
request: The request that contains all the new API key information.
"""
return self.start().uri('/api/api-key') \
.url_segment(api_key_id) \
.url_segment(key_id) \
.body_handler(JSONBodyHandler(request)) \
.put() \
.go()
Expand Down Expand Up @@ -4730,7 +4730,7 @@ def validate_device(self, user_code, client_id):

Attributes:
user_code: The end-user verification code.
client_id: The client id.
client_id: The client Id.
"""
return self.start_anonymous().uri('/oauth2/device/validate') \
.url_parameter('user_code', self.convert_true_false(user_code)) \
Expand Down