fusionauth_client 1.57.0 → 1.58.1

data/doc/table_of_contents.html

@@ -1338,6 +1338,16 @@
     —
     <span class="container">FusionAuth::FusionAuthClient</span>
 
+  <li class="method">
+    <a href="FusionAuth/FusionAuthClient.html#method-i-retrieve_webhook_attempt_log">#retrieve_webhook_attempt_log</a>
+    &mdash;
+    <span class="container">FusionAuth::FusionAuthClient</span>
+
+  <li class="method">
+    <a href="FusionAuth/FusionAuthClient.html#method-i-retrieve_webhook_event_log">#retrieve_webhook_event_log</a>
+    &mdash;
+    <span class="container">FusionAuth::FusionAuthClient</span>
+
   <li class="method">
     <a href="FusionAuth/FusionAuthClient.html#method-i-retrieve_webhooks">#retrieve_webhooks</a>
     &mdash;
@@ -1498,6 +1508,11 @@
     &mdash;
     <span class="container">FusionAuth::FusionAuthClient</span>
 
+  <li class="method">
+    <a href="FusionAuth/FusionAuthClient.html#method-i-search_webhook_event_logs">#search_webhook_event_logs</a>
+    &mdash;
+    <span class="container">FusionAuth::FusionAuthClient</span>
+
   <li class="method">
     <a href="FusionAuth/FusionAuthClient.html#method-i-search_webhooks">#search_webhooks</a>
     &mdash;

data/fusionauth_client.gemspec

@@ -19,7 +19,7 @@ $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 
 Gem::Specification.new do |spec|
   spec.name = 'fusionauth_client'
-  spec.version = '1.57.0'
+  spec.version = '1.58.1'
   spec.authors = ['Brian Pontarelli', 'Daniel DeGroff']
   spec.email = %w(brian@fusionauth.io daniel@fusionauth.io)
 

data/lib/fusionauth/fusionauth_client.rb

@@ -2,7 +2,7 @@ require 'ostruct'
 require 'fusionauth/rest_client'
 
 #
-# 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.
@@ -134,6 +134,24 @@ module FusionAuth
           .go
     end
 
+    #
+    # Changes a user's password using their access token (JWT) instead of the changePasswordId
+    # A common use case for this method will be if you want to allow the user to change their own password.
+    # 
+    # Remember to send refreshToken in the request body if you want to get a new refresh token when login using the returned oneTimePassword.
+    #
+    # @param encoded_jwt [string] The encoded JWT (access token).
+    # @param request [OpenStruct, Hash] The change password request that contains all the information used to change the password.
+    # @return [FusionAuth::ClientResponse] The ClientResponse object.
+    # @deprecated This method has been renamed to change_password_using_jwt, use that method instead.
+    def change_password_by_jwt(encoded_jwt, request)
+      startAnonymous.uri('/api/user/change-password')
+          .authorization('Bearer ' + encoded_jwt)
+          .body_handler(FusionAuth::JSONBodyHandler.new(request))
+          .post
+          .go
+    end
+
     #
     # Changes a user's password using their identity (loginId and password). Using a loginId instead of the changePasswordId
     # bypasses the email verification and allows a password to be changed directly without first calling the #forgotPassword
@@ -148,6 +166,23 @@ module FusionAuth
           .go
     end
 
+    #
+    # Changes a user's password using their access token (JWT) instead of the changePasswordId
+    # A common use case for this method will be if you want to allow the user to change their own password.
+    # 
+    # Remember to send refreshToken in the request body if you want to get a new refresh token when login using the returned oneTimePassword.
+    #
+    # @param encoded_jwt [string] The encoded JWT (access token).
+    # @param request [OpenStruct, Hash] The change password request that contains all the information used to change the password.
+    # @return [FusionAuth::ClientResponse] The ClientResponse object.
+    def change_password_using_jwt(encoded_jwt, request)
+      startAnonymous.uri('/api/user/change-password')
+          .authorization('Bearer ' + encoded_jwt)
+          .body_handler(FusionAuth::JSONBodyHandler.new(request))
+          .post
+          .go
+    end
+
     #
     # Check to see if the user must obtain a Trust Token Id in order to complete a change password request.
     # When a user has enabled Two-Factor authentication, before you are allowed to use the Change Password API to change
@@ -734,7 +769,7 @@ module FusionAuth
     end
 
     #
-    # Deactivates the users with the given ids.
+    # Deactivates the users with the given Ids.
     #
     # @param user_ids [Array] The ids of the users to deactivate.
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
@@ -749,7 +784,7 @@ module FusionAuth
     end
 
     #
-    # Deactivates the users with the given ids.
+    # Deactivates the users with the given Ids.
     #
     # @param user_ids [Array] The ids of the users to deactivate.
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
@@ -1191,8 +1226,8 @@ module FusionAuth
     end
 
     #
-    # 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.
@@ -1208,8 +1243,8 @@ module FusionAuth
     end
 
     #
-    # 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.
@@ -1730,7 +1765,7 @@ module FusionAuth
     # Modifies a temporal user action by changing the expiration of the action and optionally adding a comment to the
     # action.
     #
-    # @param action_id [string] The Id of the action to modify. This is technically the user action log id.
+    # @param action_id [string] The Id of the action to modify. This is technically the user action log Id.
     # @param request [OpenStruct, Hash] The request that contains all the information about the modification.
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
     def modify_action(action_id, request)
@@ -1754,16 +1789,16 @@ module FusionAuth
     end
 
     #
-    # Updates an authentication API key by given id
+    # Updates an API key with the given Id.
     #
-    # @param key_id [string] The Id of the authentication key. If not provided a secure random api key will be generated.
-    # @param request [OpenStruct, Hash] The request object that contains all the information needed to create the APIKey.
+    # @param key_id [string] The Id of the API key. If not provided a secure random api key will be generated.
+    # @param request [OpenStruct, Hash] The request object that contains all the information needed to create the API key.
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
     def patch_api_key(key_id, request)
       start.uri('/api/api-key')
           .url_segment(key_id)
           .body_handler(FusionAuth::JSONBodyHandler.new(request))
-          .post
+          .patch
           .go
     end
 
@@ -2272,7 +2307,7 @@ module FusionAuth
     end
 
     #
-    # Removes a user from the family with the given id.
+    # Removes a user from the family with the given Id.
     #
     # @param family_id [string] The Id of the family to remove the user from.
     # @param user_id [string] The Id of the user to remove from the family.
@@ -2327,7 +2362,7 @@ module FusionAuth
     end
 
     #
-    # Retrieves an authentication API key for the given id
+    # Retrieves an authentication API key for the given Id.
     #
     # @param key_id [string] The Id of the API key to retrieve.
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
@@ -2393,7 +2428,7 @@ module FusionAuth
     #
     # Retrieves the application for the given Id or all the applications if the Id is null.
     #
-    # @param application_id [string] (Optional) The application id.
+    # @param application_id [string] (Optional) The application Id.
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
     def retrieve_application(application_id)
       start.uri('/api/application')
@@ -2469,10 +2504,10 @@ module FusionAuth
     end
 
     #
-    # 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.
     #
-    # @param application_id [string] (Optional) The application id.
+    # @param application_id [string] (Optional) The application Id.
     # @param start [OpenStruct, Hash] The start instant as UTC milliseconds since Epoch.
     # @param _end [OpenStruct, Hash] The end instant as UTC milliseconds since Epoch.
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
@@ -2486,7 +2521,7 @@ module FusionAuth
     end
 
     #
-    # 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.
     #
     # @param email_template_id [string] (Optional) The Id of the email template.
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
@@ -2869,10 +2904,10 @@ module FusionAuth
     end
 
     #
-    # 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.
     #
-    # @param application_id [string] (Optional) The application id.
+    # @param application_id [string] (Optional) The application Id.
     # @param start [OpenStruct, Hash] The start instant as UTC milliseconds since Epoch.
     # @param _end [OpenStruct, Hash] The end instant as UTC milliseconds since Epoch.
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
@@ -2886,7 +2921,7 @@ module FusionAuth
     end
 
     #
-    # 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.
     #
     # @param message_template_id [string] (Optional) The Id of the message template.
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
@@ -2942,10 +2977,10 @@ module FusionAuth
     end
 
     #
-    # 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.
     #
-    # @param application_id [string] (Optional) The application id.
+    # @param application_id [string] (Optional) The application Id.
     # @param start [OpenStruct, Hash] The start instant as UTC milliseconds since Epoch.
     # @param _end [OpenStruct, Hash] The end instant as UTC milliseconds since Epoch.
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
@@ -3108,7 +3143,7 @@ module FusionAuth
     end
 
     #
-    # 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.
     #
     # @param user_id [string] The Id of the user.
     # @param application_id [string] The Id of the application.
@@ -3122,10 +3157,10 @@ module FusionAuth
     end
 
     #
-    # 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.
     #
-    # @param application_id [string] (Optional) The application id.
+    # @param application_id [string] (Optional) The application Id.
     # @param start [OpenStruct, Hash] The start instant as UTC milliseconds since Epoch.
     # @param _end [OpenStruct, Hash] The end instant as UTC milliseconds since Epoch.
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
@@ -3288,7 +3323,7 @@ module FusionAuth
     end
 
     #
-    # 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.
     #
     # @param user_action_id [string] (Optional) The Id of the user action.
@@ -3301,7 +3336,7 @@ module FusionAuth
     end
 
     #
-    # 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.
     #
     # @param user_action_reason_id [string] (Optional) The Id of the user action reason.
@@ -3400,8 +3435,8 @@ module FusionAuth
     # 
     # This API is useful if you want to build your own login workflow to complete a device grant.
     #
-    # @param client_id [string] The client id.
-    # @param client_secret [string] The client id.
+    # @param client_id [string] The client Id.
+    # @param client_secret [string] The client Id.
     # @param user_code [string] The end-user verification code.
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
     def retrieve_user_code(client_id, client_secret, user_code)
@@ -3514,11 +3549,11 @@ module FusionAuth
     end
 
     #
-    # 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.
     #
-    # @param application_id [string] (Optional) The application id.
-    # @param user_id [string] The userId id.
+    # @param application_id [string] (Optional) The application Id.
+    # @param user_id [string] The userId Id.
     # @param start [OpenStruct, Hash] The start instant as UTC milliseconds since Epoch.
     # @param _end [OpenStruct, Hash] The end instant as UTC milliseconds since Epoch.
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
@@ -3533,11 +3568,11 @@ module FusionAuth
     end
 
     #
-    # 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.
     #
-    # @param application_id [string] (Optional) The application id.
-    # @param login_id [string] The userId id.
+    # @param application_id [string] (Optional) The application Id.
+    # @param login_id [string] The userId Id.
     # @param start [OpenStruct, Hash] The start instant as UTC milliseconds since Epoch.
     # @param _end [OpenStruct, Hash] The end instant as UTC milliseconds since Epoch.
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
@@ -3614,7 +3649,7 @@ module FusionAuth
     end
 
     #
-    # 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.
     #
     # @param webhook_id [string] (Optional) The Id of the webhook.
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
@@ -3846,7 +3881,7 @@ module FusionAuth
     end
 
     #
-    # 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.
     #
     # @param ids [Array] The entity ids to search for.
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
@@ -4014,7 +4049,7 @@ module FusionAuth
     end
 
     #
-    # 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.
     #
     # @param ids [Array] The user ids to search for.
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
@@ -4027,9 +4062,9 @@ module FusionAuth
     end
 
     #
-    # 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.
     #
-    # @param ids [Array] The user ids to search for.
+    # @param ids [Array] The user Ids to search for.
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
     def search_users_by_ids(ids)
       start.uri('/api/user/search')
@@ -4090,7 +4125,7 @@ module FusionAuth
     end
 
     #
-    # 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.
     #
     # @param email_template_id [string] The Id for the template.
@@ -4260,14 +4295,14 @@ module FusionAuth
     end
 
     #
-    # Updates an API key by given id
+    # Updates an API key with the given Id.
     #
-    # @param api_key_id [string] The Id of the API key to update.
-    # @param request [OpenStruct, Hash] The request object that contains all the information used to create the API Key.
+    # @param key_id [string] The Id of the API key to update.
+    # @param request [OpenStruct, Hash] The request that contains all the new API key information.
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
-    def update_api_key(api_key_id, request)
+    def update_api_key(key_id, request)
       start.uri('/api/api-key')
-          .url_segment(api_key_id)
+          .url_segment(key_id)
           .body_handler(FusionAuth::JSONBodyHandler.new(request))
           .put
           .go
@@ -4716,7 +4751,7 @@ module FusionAuth
     # If you build your own activation form you should validate the user provided code prior to beginning the Authorization grant.
     #
     # @param user_code [string] The end-user verification code.
-    # @param client_id [string] The client id.
+    # @param client_id [string] The client Id.
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
     def validate_device(user_code, client_id)
       startAnonymous.uri('/oauth2/device/validate')

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fusionauth_client
 version: !ruby/object:Gem::Version
-  version: 1.57.0
+  version: 1.58.1
 platform: ruby
 authors:
 - Brian Pontarelli
 - Daniel DeGroff
 bindir: exe
 cert_chain: []
-date: 2025-04-07 00:00:00.000000000 Z
+date: 2025-07-23 00:00:00.000000000 Z
 dependencies: []
 description: This library contains the Ruby client library that helps you connect
   your application to FusionAuth.