fusionauth_client 1.49.1 → 1.50.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
 - data/.github/dependabot.yml +6 -0
 - data/.github/fusionauth/.env +6 -0
 - data/.github/fusionauth/docker-compose.yml +51 -0
 - data/.github/fusionauth/kickstart.json +46 -0
 - data/.github/workflows/docs.yml +31 -0
 - data/.github/workflows/test.yml +31 -0
 - data/.ruby-version +1 -1
 - data/Gemfile +5 -6
 - data/Gemfile.lock +20 -23
 - data/README.md +225 -0
 - data/build.savant +2 -2
 - data/doc/FusionAuth/FusionAuthClient.html +14185 -0
 - data/doc/FusionAuth/FusionAuthClient.md +197 -80
 - data/doc/FusionAuth.html +108 -0
 - data/doc/FusionAuth.md +1 -1
 - data/doc/created.rid +2 -2
 - data/doc/css/fonts.css +167 -0
 - data/doc/css/rdoc.css +619 -0
 - data/doc/fonts/Lato-Light.ttf +0 -0
 - data/doc/fonts/Lato-LightItalic.ttf +0 -0
 - data/doc/fonts/Lato-Regular.ttf +0 -0
 - data/doc/fonts/Lato-RegularItalic.ttf +0 -0
 - data/doc/fonts/SourceCodePro-Bold.ttf +0 -0
 - data/doc/fonts/SourceCodePro-Regular.ttf +0 -0
 - data/doc/images/add.png +0 -0
 - data/doc/images/arrow_up.png +0 -0
 - data/doc/images/brick.png +0 -0
 - data/doc/images/brick_link.png +0 -0
 - data/doc/images/bug.png +0 -0
 - data/doc/images/bullet_black.png +0 -0
 - data/doc/images/bullet_toggle_minus.png +0 -0
 - data/doc/images/bullet_toggle_plus.png +0 -0
 - data/doc/images/date.png +0 -0
 - data/doc/images/delete.png +0 -0
 - data/doc/images/find.png +0 -0
 - data/doc/images/loadingAnimation.gif +0 -0
 - data/doc/images/macFFBgHack.png +0 -0
 - data/doc/images/package.png +0 -0
 - data/doc/images/page_green.png +0 -0
 - data/doc/images/page_white_text.png +0 -0
 - data/doc/images/page_white_width.png +0 -0
 - data/doc/images/plugin.png +0 -0
 - data/doc/images/ruby.png +0 -0
 - data/doc/images/tag_blue.png +0 -0
 - data/doc/images/tag_green.png +0 -0
 - data/doc/images/transparent.png +0 -0
 - data/doc/images/wrench.png +0 -0
 - data/doc/images/wrench_orange.png +0 -0
 - data/doc/images/zoom.png +0 -0
 - data/doc/index.html +89 -0
 - data/doc/js/darkfish.js +84 -0
 - data/doc/js/navigation.js +105 -0
 - data/doc/js/navigation.js.gz +0 -0
 - data/doc/js/search.js +110 -0
 - data/doc/js/search_index.js +1 -0
 - data/doc/js/search_index.js.gz +0 -0
 - data/doc/js/searcher.js +229 -0
 - data/doc/js/searcher.js.gz +0 -0
 - data/doc/table_of_contents.html +1765 -0
 - data/fusionauth-ruby-client.iml +1 -4
 - data/fusionauth_client.gemspec +2 -2
 - data/lib/fusionauth/fusionauth_client.rb +84 -1
 - data/lib/fusionauth/rest_client.rb +1 -1
 - metadata +54 -4
 - data/README.adoc +0 -106
 - data/doc/index.db +0 -0
 
| 
         @@ -17,40 +17,45 @@ noinspection RubyInstanceMethodNamingConvention,RubyTooManyMethodsInspection,Rub 
     | 
|
| 
       17 
17 
     | 
    
         
             
             ### action_user(request) [](#method-i-action_user)
         
     | 
| 
       18 
18 
     | 
    
         
             
             Takes an action on a user. The user being actioned is called the “actionee” and the user taking the action is called the “actioner”. Both user ids are required in the request object.
         
     | 
| 
       19 
19 
     | 
    
         | 
| 
       20 
     | 
    
         
            -
            @param request [OpenStruct, Hash] The action request that includes all  
     | 
| 
      
 20 
     | 
    
         
            +
            @param request [OpenStruct, Hash] The action request that includes all the information about the action being taken including
         
     | 
| 
       21 
21 
     | 
    
         | 
| 
       22 
22 
     | 
    
         
             
            ```
         
     | 
| 
       23 
     | 
    
         
            -
            the  
     | 
| 
      
 23 
     | 
    
         
            +
            the Id of the action, any options and the duration (if applicable).
         
     | 
| 
       24 
24 
     | 
    
         
             
            ```
         
     | 
| 
       25 
25 
     | 
    
         | 
| 
       26 
26 
     | 
    
         
             
            @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       27 
27 
     | 
    
         | 
| 
       28 
28 
     | 
    
         
             
             ### activate_reactor(request) [](#method-i-activate_reactor)
         
     | 
| 
       29 
     | 
    
         
            -
             Activates the [`FusionAuth`](../FusionAuth.html) Reactor using a license  
     | 
| 
      
 29 
     | 
    
         
            +
             Activates the [`FusionAuth`](../FusionAuth.html) Reactor using a license Id and optionally a license text (for air-gapped deployments)
         
     | 
| 
       30 
30 
     | 
    
         | 
| 
       31 
31 
     | 
    
         
             
            @param request [OpenStruct, Hash] An optional request that contains the license text to activate Reactor (useful for air-gap deployments of [`FusionAuth`](../FusionAuth.html)). @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       32 
32 
     | 
    
         | 
| 
       33 
33 
     | 
    
         
             
             ### add_user_to_family(family_id, request) [](#method-i-add_user_to_family)
         
     | 
| 
       34 
     | 
    
         
            -
             Adds a user to an existing family. The family  
     | 
| 
      
 34 
     | 
    
         
            +
             Adds a user to an existing family. The family Id must be specified.
         
     | 
| 
       35 
35 
     | 
    
         | 
| 
       36 
     | 
    
         
            -
            @param family\_id [string] The  
     | 
| 
      
 36 
     | 
    
         
            +
            @param family\_id [string] The Id of the family. @param request [OpenStruct, Hash] The request object that contains all the information used to determine which user to add to the family. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
      
 37 
     | 
    
         
            +
             
     | 
| 
      
 38 
     | 
    
         
            +
             ### approve_device(client_id, client_secret, token, user_code) [](#method-i-approve_device)
         
     | 
| 
      
 39 
     | 
    
         
            +
             Approve a device grant.
         
     | 
| 
      
 40 
     | 
    
         
            +
             
     | 
| 
      
 41 
     | 
    
         
            +
            @param client\_id [string] (Optional) The unique client identifier. The client Id is the Id of the [`FusionAuth`](../FusionAuth.html) Application in which you are attempting to authenticate. @param client\_secret [string] (Optional) The client secret. This value will be required if client authentication is enabled. @param token [string] The access token used to identify the user. @param user\_code [string] The end-user verification code. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       37 
42 
     | 
    
         | 
| 
       38 
43 
     | 
    
         
             
             ### cancel_action(action_id, request) [](#method-i-cancel_action)
         
     | 
| 
       39 
44 
     | 
    
         
             
             Cancels the user action.
         
     | 
| 
       40 
45 
     | 
    
         | 
| 
       41 
     | 
    
         
            -
            @param action\_id [string] The action  
     | 
| 
      
 46 
     | 
    
         
            +
            @param action\_id [string] The action Id of the action to cancel. @param request [OpenStruct, Hash] The action request that contains the information about the cancellation. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       42 
47 
     | 
    
         | 
| 
       43 
48 
     | 
    
         
             
             ### change_password(change_password_id, request) [](#method-i-change_password)
         
     | 
| 
       44 
49 
     | 
    
         
             
             Changes a user’s password using the change password Id. This usually occurs after an email has been sent to the user and they clicked on a link to reset their password.
         
     | 
| 
       45 
50 
     | 
    
         | 
| 
       46 
51 
     | 
    
         
             
            As of version 1.32.2, prefer sending the changePasswordId in the request body. To do this, omit the first parameter, and set the value in the request body.
         
     | 
| 
       47 
52 
     | 
    
         | 
| 
       48 
     | 
    
         
            -
            @param change\_password\_id [string] The change password Id used to find the user. This value is generated by [`FusionAuth`](../FusionAuth.html) once the change password workflow has been initiated. @param request [OpenStruct, Hash] The change password request that contains all  
     | 
| 
      
 53 
     | 
    
         
            +
            @param change\_password\_id [string] The change password Id used to find the user. This value is generated by [`FusionAuth`](../FusionAuth.html) once the change password workflow has been initiated. @param request [OpenStruct, Hash] The change password request that contains all the information used to change the password. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       49 
54 
     | 
    
         | 
| 
       50 
55 
     | 
    
         
             
             ### change_password_by_identity(request) [](#method-i-change_password_by_identity)
         
     | 
| 
       51 
     | 
    
         
            -
             Changes a user’s password using their identity ( 
     | 
| 
      
 56 
     | 
    
         
            +
             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 method.
         
     | 
| 
       52 
57 
     | 
    
         | 
| 
       53 
     | 
    
         
            -
            @param request [OpenStruct, Hash] The change password request that contains all  
     | 
| 
      
 58 
     | 
    
         
            +
            @param request [OpenStruct, Hash] The change password request that contains all the information used to change the password. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       54 
59 
     | 
    
         | 
| 
       55 
60 
     | 
    
         
             
             ### check_change_password_using_id(change_password_id) [](#method-i-check_change_password_using_id)
         
     | 
| 
       56 
61 
     | 
    
         
             
             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 your password, you must obtain a Trust Token by completing a Two-Factor Step-Up authentication.
         
     | 
| 
         @@ -76,7 +81,19 @@ An HTTP status code of 400 with a general error code of [TrustTokenRequired] ind 
     | 
|
| 
       76 
81 
     | 
    
         
             
             ### client_credentials_grant(client_id, client_secret, scope) [](#method-i-client_credentials_grant)
         
     | 
| 
       77 
82 
     | 
    
         
             
             Make a Client Credentials grant request to obtain an access token.
         
     | 
| 
       78 
83 
     | 
    
         | 
| 
       79 
     | 
    
         
            -
            @param client\_id [string] The client identifier. The client Id is the Id of the [`FusionAuth`](../FusionAuth.html) Entity in which you are attempting to authenticate. 
     | 
| 
      
 84 
     | 
    
         
            +
            @param client\_id [string] (Optional) The client identifier. The client Id is the Id of the [`FusionAuth`](../FusionAuth.html) Entity in which you are attempting to authenticate.
         
     | 
| 
      
 85 
     | 
    
         
            +
             
     | 
| 
      
 86 
     | 
    
         
            +
            ```
         
     | 
| 
      
 87 
     | 
    
         
            +
            This parameter is optional when Basic Authorization is used to authenticate this request.
         
     | 
| 
      
 88 
     | 
    
         
            +
            ```
         
     | 
| 
      
 89 
     | 
    
         
            +
             
     | 
| 
      
 90 
     | 
    
         
            +
            @param client\_secret [string] (Optional) The client secret used to authenticate this request.
         
     | 
| 
      
 91 
     | 
    
         
            +
             
     | 
| 
      
 92 
     | 
    
         
            +
            ```
         
     | 
| 
      
 93 
     | 
    
         
            +
            This parameter is optional when Basic Authorization is used to authenticate this request.
         
     | 
| 
      
 94 
     | 
    
         
            +
            ```
         
     | 
| 
      
 95 
     | 
    
         
            +
             
     | 
| 
      
 96 
     | 
    
         
            +
            @param scope [string] (Optional) This parameter is used to indicate which target entity you are requesting access. To request access to an entity, use the format target-entity:<target-entity-id>:<roles>. Roles are an optional comma separated list. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       80 
97 
     | 
    
         | 
| 
       81 
98 
     | 
    
         
             
             ### comment_on_user(request) [](#method-i-comment_on_user)
         
     | 
| 
       82 
99 
     | 
    
         
             
             Adds a comment to the user’s account.
         
     | 
| 
         @@ -103,7 +120,7 @@ An HTTP status code of 400 with a general error code of [TrustTokenRequired] ind 
     | 
|
| 
       103 
120 
     | 
    
         | 
| 
       104 
121 
     | 
    
         
             
            If an API key is locked to a tenant, it can only create API Keys for that same tenant.
         
     | 
| 
       105 
122 
     | 
    
         | 
| 
       106 
     | 
    
         
            -
            @param key\_id [string] (Optional) The unique Id of the API key. If not provided a secure random Id will be generated. @param request [OpenStruct, Hash] The request object that contains all  
     | 
| 
      
 123 
     | 
    
         
            +
            @param key\_id [string] (Optional) The unique Id of the API key. If not provided a secure random Id will be generated. @param request [OpenStruct, Hash] The request object that contains all the information needed to create the APIKey. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       107 
124 
     | 
    
         | 
| 
       108 
125 
     | 
    
         
             
             ### create_application(application_id, request) [](#method-i-create_application)
         
     | 
| 
       109 
126 
     | 
    
         
             
             Creates an application. You can optionally specify an Id for the application, if not provided one will be generated.
         
     | 
| 
         @@ -111,7 +128,7 @@ If an API key is locked to a tenant, it can only create API Keys for that same t 
     | 
|
| 
       111 
128 
     | 
    
         
             
            @param application\_id [string] (Optional) The Id to use for the application. If not provided a secure random UUID will be generated. @param request [OpenStruct, Hash] The request object that contains all the information used to create the application. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       112 
129 
     | 
    
         | 
| 
       113 
130 
     | 
    
         
             
             ### create_application_role(application_id, role_id, request) [](#method-i-create_application_role)
         
     | 
| 
       114 
     | 
    
         
            -
             Creates a new role for an application. You must specify the  
     | 
| 
      
 131 
     | 
    
         
            +
             Creates a new role for an application. You must specify the Id of the application you are creating the role for. You can optionally specify an Id for the role inside the ApplicationRole object itself, if not provided one will be generated.
         
     | 
| 
       115 
132 
     | 
    
         | 
| 
       116 
133 
     | 
    
         
             
            @param application\_id [string] The Id of the application to create the role on. @param role\_id [string] (Optional) The Id of the role. If not provided a secure random UUID will be generated. @param request [OpenStruct, Hash] The request object that contains all the information used to create the application role. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       117 
134 
     | 
    
         | 
| 
         @@ -146,14 +163,14 @@ If an API key is locked to a tenant, it can only create API Keys for that same t 
     | 
|
| 
       146 
163 
     | 
    
         
             
            @param entity\_type\_id [string] (Optional) The Id for the Entity Type. If not provided a secure random UUID will be generated. @param request [OpenStruct, Hash] The request object that contains all the information used to create the Entity Type. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       147 
164 
     | 
    
         | 
| 
       148 
165 
     | 
    
         
             
             ### create_entity_type_permission(entity_type_id, permission_id, request) [](#method-i-create_entity_type_permission)
         
     | 
| 
       149 
     | 
    
         
            -
             Creates a new permission for an entity type. You must specify the  
     | 
| 
      
 166 
     | 
    
         
            +
             Creates a new permission for an entity type. You must specify the Id of the entity type you are creating the permission for. You can optionally specify an Id for the permission inside the EntityTypePermission object itself, if not provided one will be generated.
         
     | 
| 
       150 
167 
     | 
    
         | 
| 
       151 
168 
     | 
    
         
             
            @param entity\_type\_id [string] The Id of the entity type to create the permission on. @param permission\_id [string] (Optional) The Id of the permission. If not provided a secure random UUID will be generated. @param request [OpenStruct, Hash] The request object that contains all the information used to create the permission. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       152 
169 
     | 
    
         | 
| 
       153 
170 
     | 
    
         
             
             ### create_family(family_id, request) [](#method-i-create_family)
         
     | 
| 
       154 
     | 
    
         
            -
             Creates a family with the user  
     | 
| 
      
 171 
     | 
    
         
            +
             Creates a family with the user Id in the request as the owner and sole member of the family. You can optionally specify an Id for the family, if not provided one will be generated.
         
     | 
| 
       155 
172 
     | 
    
         | 
| 
       156 
     | 
    
         
            -
            @param family\_id [string] (Optional) The  
     | 
| 
      
 173 
     | 
    
         
            +
            @param family\_id [string] (Optional) The Id for the family. If not provided a secure random UUID will be generated. @param request [OpenStruct, Hash] The request object that contains all the information used to create the family. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       157 
174 
     | 
    
         | 
| 
       158 
175 
     | 
    
         
             
             ### create_form(form_id, request) [](#method-i-create_form)
         
     | 
| 
       159 
176 
     | 
    
         
             
             Creates a form. You can optionally specify an Id for the form, if not provided one will be generated.
         
     | 
| 
         @@ -338,7 +355,7 @@ If an API key is locked to a tenant, it can only create API Keys for that same t 
     | 
|
| 
       338 
355 
     | 
    
         
             
             ### delete_group_members(request) [](#method-i-delete_group_members)
         
     | 
| 
       339 
356 
     | 
    
         
             
             Removes users as members of a group.
         
     | 
| 
       340 
357 
     | 
    
         | 
| 
       341 
     | 
    
         
            -
            @param request [OpenStruct, Hash] The member request that contains all  
     | 
| 
      
 358 
     | 
    
         
            +
            @param request [OpenStruct, Hash] The member request that contains all the information used to remove members to the group. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       342 
359 
     | 
    
         | 
| 
       343 
360 
     | 
    
         
             
             ### delete_identity_provider(identity_provider_id) [](#method-i-delete_identity_provider)
         
     | 
| 
       344 
361 
     | 
    
         
             
             Deletes the identity provider for the given Id.
         
     | 
| 
         @@ -467,17 +484,35 @@ This method can be used to deactivate or permanently delete (hard-delete) users 
     | 
|
| 
       467 
484 
     | 
    
         
             
             ### exchange_o_auth_code_for_access_token(code, client_id, client_secret, redirect_uri) [](#method-i-exchange_o_auth_code_for_access_token)
         
     | 
| 
       468 
485 
     | 
    
         
             
             Exchanges an OAuth authorization code for an access token. Makes a request to the Token endpoint to exchange the authorization code returned from the Authorize endpoint for an access token.
         
     | 
| 
       469 
486 
     | 
    
         | 
| 
       470 
     | 
    
         
            -
            @param code [string] The authorization code returned on the /oauth2/authorize response. @param client\_id [string] The unique client identifier. The client Id is the Id of the [`FusionAuth`](../FusionAuth.html) Application in which you are attempting to authenticate. 
     | 
| 
      
 487 
     | 
    
         
            +
            @param code [string] The authorization code returned on the /oauth2/authorize response. @param client\_id [string] (Optional) The unique client identifier. The client Id is the Id of the [`FusionAuth`](../FusionAuth.html) Application in which you are attempting to authenticate.
         
     | 
| 
      
 488 
     | 
    
         
            +
             
     | 
| 
      
 489 
     | 
    
         
            +
            ```
         
     | 
| 
      
 490 
     | 
    
         
            +
            This parameter is optional when Basic Authorization is used to authenticate this request.
         
     | 
| 
      
 491 
     | 
    
         
            +
            ```
         
     | 
| 
      
 492 
     | 
    
         
            +
             
     | 
| 
      
 493 
     | 
    
         
            +
            @param client\_secret [string] (Optional) The client secret. This value will be required if client authentication is enabled. @param redirect\_uri [string] The URI to redirect to upon a successful request. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       471 
494 
     | 
    
         | 
| 
       472 
495 
     | 
    
         
             
             ### exchange_o_auth_code_for_access_token_using_pkce(code, client_id, client_secret, redirect_uri, code_verifier) [](#method-i-exchange_o_auth_code_for_access_token_using_pkce)
         
     | 
| 
       473 
496 
     | 
    
         
             
             Exchanges an OAuth authorization code and code\_verifier for an access token. Makes a request to the Token endpoint to exchange the authorization code returned from the Authorize endpoint and a code\_verifier for an access token.
         
     | 
| 
       474 
497 
     | 
    
         | 
| 
       475 
     | 
    
         
            -
            @param code [string] The authorization code returned on the /oauth2/authorize response. @param client\_id [string] (Optional) The unique client identifier. The client Id is the Id of the [`FusionAuth`](../FusionAuth.html) Application in which you are attempting to authenticate. This parameter is optional when the Authorization header is provided. 
     | 
| 
      
 498 
     | 
    
         
            +
            @param code [string] The authorization code returned on the /oauth2/authorize response. @param client\_id [string] (Optional) The unique client identifier. The client Id is the Id of the [`FusionAuth`](../FusionAuth.html) Application in which you are attempting to authenticate. This parameter is optional when the Authorization header is provided.
         
     | 
| 
      
 499 
     | 
    
         
            +
             
     | 
| 
      
 500 
     | 
    
         
            +
            ```
         
     | 
| 
      
 501 
     | 
    
         
            +
            This parameter is optional when Basic Authorization is used to authenticate this request.
         
     | 
| 
      
 502 
     | 
    
         
            +
            ```
         
     | 
| 
      
 503 
     | 
    
         
            +
             
     | 
| 
      
 504 
     | 
    
         
            +
            @param client\_secret [string] (Optional) The client secret. This value may optionally be provided in the request body instead of the Authorization header. @param redirect\_uri [string] The URI to redirect to upon a successful request. @param code\_verifier [string] The random string generated previously. Will be compared with the code\_challenge sent previously, which allows the OAuth provider to authenticate your app. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       476 
505 
     | 
    
         | 
| 
       477 
506 
     | 
    
         
             
             ### exchange_refresh_token_for_access_token(refresh_token, client_id, client_secret, scope, user_code) [](#method-i-exchange_refresh_token_for_access_token)
         
     | 
| 
       478 
507 
     | 
    
         
             
             Exchange a Refresh Token for an Access Token. If you will be using the Refresh Token Grant, you will make a request to the Token endpoint to exchange the user’s refresh token for an access token.
         
     | 
| 
       479 
508 
     | 
    
         | 
| 
       480 
     | 
    
         
            -
            @param refresh\_token [string] The refresh token that you would like to use to exchange for an access token. @param client\_id [string] (Optional) The unique client identifier. The client Id is the Id of the [`FusionAuth`](../FusionAuth.html) Application in which you are attempting to authenticate. This parameter is optional when the Authorization header is provided. 
     | 
| 
      
 509 
     | 
    
         
            +
            @param refresh\_token [string] The refresh token that you would like to use to exchange for an access token. @param client\_id [string] (Optional) The unique client identifier. The client Id is the Id of the [`FusionAuth`](../FusionAuth.html) Application in which you are attempting to authenticate. This parameter is optional when the Authorization header is provided.
         
     | 
| 
      
 510 
     | 
    
         
            +
             
     | 
| 
      
 511 
     | 
    
         
            +
            ```
         
     | 
| 
      
 512 
     | 
    
         
            +
            This parameter is optional when Basic Authorization is used to authenticate this request.
         
     | 
| 
      
 513 
     | 
    
         
            +
            ```
         
     | 
| 
      
 514 
     | 
    
         
            +
             
     | 
| 
      
 515 
     | 
    
         
            +
            @param client\_secret [string] (Optional) The client secret. This value may optionally be provided in the request body instead of the Authorization header. @param scope [string] (Optional) This parameter is optional and if omitted, the same scope requested during the authorization request will be used. If provided the scopes must match those requested during the initial authorization request. @param user\_code [string] (Optional) The end-user verification code. This code is required if using this endpoint to approve the Device Authorization. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       481 
516 
     | 
    
         | 
| 
       482 
517 
     | 
    
         
             
             ### exchange_refresh_token_for_jwt(request) [](#method-i-exchange_refresh_token_for_jwt)
         
     | 
| 
       483 
518 
     | 
    
         
             
             Exchange a refresh token for a new JWT.
         
     | 
| 
         @@ -487,7 +522,13 @@ This method can be used to deactivate or permanently delete (hard-delete) users 
     | 
|
| 
       487 
522 
     | 
    
         
             
             ### exchange_user_credentials_for_access_token(username, password, client_id, client_secret, scope, user_code) [](#method-i-exchange_user_credentials_for_access_token)
         
     | 
| 
       488 
523 
     | 
    
         
             
             Exchange User Credentials for a Token. If you will be using the Resource Owner Password Credential Grant, you will make a request to the Token endpoint to exchange the user’s email and password for an access token.
         
     | 
| 
       489 
524 
     | 
    
         | 
| 
       490 
     | 
    
         
            -
            @param username [string] The login identifier of the user. The login identifier can be either the email or the username. @param password [string] The user’s password. @param client\_id [string] (Optional) The unique client identifier. The client Id is the Id of the [`FusionAuth`](../FusionAuth.html) Application in which you are attempting to authenticate. This parameter is optional when the Authorization header is provided. 
     | 
| 
      
 525 
     | 
    
         
            +
            @param username [string] The login identifier of the user. The login identifier can be either the email or the username. @param password [string] The user’s password. @param client\_id [string] (Optional) The unique client identifier. The client Id is the Id of the [`FusionAuth`](../FusionAuth.html) Application in which you are attempting to authenticate. This parameter is optional when the Authorization header is provided.
         
     | 
| 
      
 526 
     | 
    
         
            +
             
     | 
| 
      
 527 
     | 
    
         
            +
            ```
         
     | 
| 
      
 528 
     | 
    
         
            +
            This parameter is optional when Basic Authorization is used to authenticate this request.
         
     | 
| 
      
 529 
     | 
    
         
            +
            ```
         
     | 
| 
      
 530 
     | 
    
         
            +
             
     | 
| 
      
 531 
     | 
    
         
            +
            @param client\_secret [string] (Optional) The client secret. This value may optionally be provided in the request body instead of the Authorization header. @param scope [string] (Optional) This parameter is optional and if omitted, the same scope requested during the authorization request will be used. If provided the scopes must match those requested during the initial authorization request. @param user\_code [string] (Optional) The end-user verification code. This code is required if using this endpoint to approve the Device Authorization. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       491 
532 
     | 
    
         | 
| 
       492 
533 
     | 
    
         
             
             ### forgot_password(request) [](#method-i-forgot_password)
         
     | 
| 
       493 
534 
     | 
    
         
             
             Begins the forgot password sequence, which kicks off an email to the user so that they can reset their password.
         
     | 
| 
         @@ -545,14 +586,14 @@ providers that FusionAuth uses to reconcile the user's account. 
     | 
|
| 
       545 
586 
     | 
    
         | 
| 
       546 
587 
     | 
    
         
             
            Therefore, if you encounter an error due to a database key violation, the response will likely offer a generic explanation. If you encounter an error, you may optionally enable additional validation to receive a JSON response body with specific validation errors. This will slow the request down but will allow you to identify the cause of the failure. See the validateDbConstraints request parameter.
         
     | 
| 
       547 
588 
     | 
    
         | 
| 
       548 
     | 
    
         
            -
            @param request [OpenStruct, Hash] The request that contains all  
     | 
| 
      
 589 
     | 
    
         
            +
            @param request [OpenStruct, Hash] The request that contains all the information about all the refresh tokens to import. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       549 
590 
     | 
    
         | 
| 
       550 
591 
     | 
    
         
             
             ### import_users(request) [](#method-i-import_users)
         
     | 
| 
       551 
592 
     | 
    
         
             
             Bulk imports users. This request performs minimal validation and runs batch inserts of users with the expectation that each user does not yet exist and each registration corresponds to an existing [`FusionAuth`](../FusionAuth.html) Application. This is done to increases the insert performance.
         
     | 
| 
       552 
593 
     | 
    
         | 
| 
       553 
594 
     | 
    
         
             
            Therefore, if you encounter an error due to a database key violation, the response will likely offer a generic explanation. If you encounter an error, you may optionally enable additional validation to receive a JSON response body with specific validation errors. This will slow the request down but will allow you to identify the cause of the failure. See the validateDbConstraints request parameter.
         
     | 
| 
       554 
595 
     | 
    
         | 
| 
       555 
     | 
    
         
            -
            @param request [OpenStruct, Hash] The request that contains all  
     | 
| 
      
 596 
     | 
    
         
            +
            @param request [OpenStruct, Hash] The request that contains all the information about all the users to import. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       556 
597 
     | 
    
         | 
| 
       557 
598 
     | 
    
         
             
             ### import_web_authn_credential(request) [](#method-i-import_web_authn_credential)
         
     | 
| 
       558 
599 
     | 
    
         
             
             Import a WebAuthn credential
         
     | 
| 
         @@ -560,9 +601,14 @@ Therefore, if you encounter an error due to a database key violation, the respon 
     | 
|
| 
       560 
601 
     | 
    
         
             
            @param request [OpenStruct, Hash] An object containing data necessary for importing the credential @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       561 
602 
     | 
    
         | 
| 
       562 
603 
     | 
    
         
             
             ### introspect_access_token(client_id, token) [](#method-i-introspect_access_token)
         
     | 
| 
       563 
     | 
    
         
            -
             Inspect an access token issued  
     | 
| 
      
 604 
     | 
    
         
            +
             Inspect an access token issued as the result of the User based grant such as the Authorization Code Grant, Implicit Grant, the User Credentials Grant or the Refresh Grant.
         
     | 
| 
       564 
605 
     | 
    
         | 
| 
       565 
     | 
    
         
            -
            @param client\_id [string] The unique client identifier. The client Id is the Id of the [`FusionAuth`](../FusionAuth.html) Application for which this token was generated. @param token [string] The access token returned by this OAuth provider as the result of a successful  
     | 
| 
      
 606 
     | 
    
         
            +
            @param client\_id [string] The unique client identifier. The client Id is the Id of the [`FusionAuth`](../FusionAuth.html) Application for which this token was generated. @param token [string] The access token returned by this OAuth provider as the result of a successful client credentials grant. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
      
 607 
     | 
    
         
            +
             
     | 
| 
      
 608 
     | 
    
         
            +
             ### introspect_client_credentials_access_token(token) [](#method-i-introspect_client_credentials_access_token)
         
     | 
| 
      
 609 
     | 
    
         
            +
             Inspect an access token issued as the result of the Client Credentials Grant.
         
     | 
| 
      
 610 
     | 
    
         
            +
             
     | 
| 
      
 611 
     | 
    
         
            +
            @param token [string] The access token returned by this OAuth provider as the result of a successful client credentials grant. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       566 
612 
     | 
    
         | 
| 
       567 
613 
     | 
    
         
             
             ### issue_jwt(application_id, encoded_jwt, refresh_token) [](#method-i-issue_jwt)
         
     | 
| 
       568 
614 
     | 
    
         
             
             Issue a new access token (JWT) for the requested Application after ensuring the provided JWT is valid. A valid access token is properly signed and not expired. \<p\> This API may be used in an SSO configuration to issue new tokens for another application after the user has obtained a valid token from authentication.
         
     | 
| 
         @@ -602,7 +648,7 @@ the IP address will be that of the client or last proxy that sent the request. 
     | 
|
| 
       602 
648 
     | 
    
         
             
             ### logout(global, refresh_token) [](#method-i-logout)
         
     | 
| 
       603 
649 
     | 
    
         
             
             The Logout API is intended to be used to remove the refresh token and access token cookies if they exist on the client and revoke the refresh token stored. This API does nothing if the request does not contain an access token or refresh token cookies.
         
     | 
| 
       604 
650 
     | 
    
         | 
| 
       605 
     | 
    
         
            -
            @param global [Boolean] When this value is set to true all  
     | 
| 
      
 651 
     | 
    
         
            +
            @param global [Boolean] When this value is set to true all the refresh tokens issued to the owner of the
         
     | 
| 
       606 
652 
     | 
    
         | 
| 
       607 
653 
     | 
    
         
             
            ```
         
     | 
| 
       608 
654 
     | 
    
         
             
            provided token will be revoked.
         
     | 
| 
         @@ -629,17 +675,17 @@ If provided this takes precedence over the cookie. 
     | 
|
| 
       629 
675 
     | 
    
         
             
             ### modify_action(action_id, request) [](#method-i-modify_action)
         
     | 
| 
       630 
676 
     | 
    
         
             
             Modifies a temporal user action by changing the expiration of the action and optionally adding a comment to the action.
         
     | 
| 
       631 
677 
     | 
    
         | 
| 
       632 
     | 
    
         
            -
            @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  
     | 
| 
      
 678 
     | 
    
         
            +
            @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.
         
     | 
| 
       633 
679 
     | 
    
         | 
| 
       634 
680 
     | 
    
         
             
             ### passwordless_login(request) [](#method-i-passwordless_login)
         
     | 
| 
       635 
681 
     | 
    
         
             
             Complete a login request using a passwordless code
         
     | 
| 
       636 
682 
     | 
    
         | 
| 
       637 
     | 
    
         
            -
            @param request [OpenStruct, Hash] The passwordless login request that contains all  
     | 
| 
      
 683 
     | 
    
         
            +
            @param request [OpenStruct, Hash] The passwordless login request that contains all the information used to complete login. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       638 
684 
     | 
    
         | 
| 
       639 
685 
     | 
    
         
             
             ### patch_api_key(key_id, request) [](#method-i-patch_api_key)
         
     | 
| 
       640 
686 
     | 
    
         
             
             Updates an authentication API key by given id
         
     | 
| 
       641 
687 
     | 
    
         | 
| 
       642 
     | 
    
         
            -
            @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  
     | 
| 
      
 688 
     | 
    
         
            +
            @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. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       643 
689 
     | 
    
         | 
| 
       644 
690 
     | 
    
         
             
             ### patch_application(application_id, request) [](#method-i-patch_application)
         
     | 
| 
       645 
691 
     | 
    
         
             
             Updates, via PATCH, the application with the given Id.
         
     | 
| 
         @@ -647,7 +693,7 @@ If provided this takes precedence over the cookie. 
     | 
|
| 
       647 
693 
     | 
    
         
             
            @param application\_id [string] The Id of the application to update. @param request [OpenStruct, Hash] The request that contains just the new application information. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       648 
694 
     | 
    
         | 
| 
       649 
695 
     | 
    
         
             
             ### patch_application_role(application_id, role_id, request) [](#method-i-patch_application_role)
         
     | 
| 
       650 
     | 
    
         
            -
             Updates, via PATCH, the application role with the given  
     | 
| 
      
 696 
     | 
    
         
            +
             Updates, via PATCH, the application role with the given Id for the application.
         
     | 
| 
       651 
697 
     | 
    
         | 
| 
       652 
698 
     | 
    
         
             
            @param application\_id [string] The Id of the application that the role belongs to. @param role\_id [string] The Id of the role to update. @param request [OpenStruct, Hash] The request that contains just the new role information. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       653 
699 
     | 
    
         | 
| 
         @@ -702,7 +748,7 @@ If provided this takes precedence over the cookie. 
     | 
|
| 
       702 
748 
     | 
    
         
             
            @param messenger\_id [string] The Id of the messenger to update. @param request [OpenStruct, Hash] The request that contains just the new messenger information. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       703 
749 
     | 
    
         | 
| 
       704 
750 
     | 
    
         
             
             ### patch_registration(user_id, request) [](#method-i-patch_registration)
         
     | 
| 
       705 
     | 
    
         
            -
             Updates, via PATCH, the registration for the user with the given  
     | 
| 
      
 751 
     | 
    
         
            +
             Updates, via PATCH, the registration for the user with the given Id and the application defined in the request.
         
     | 
| 
       706 
752 
     | 
    
         | 
| 
       707 
753 
     | 
    
         
             
            @param user\_id [string] The Id of the user whose registration is going to be updated. @param request [OpenStruct, Hash] The request that contains just the new registration information. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       708 
754 
     | 
    
         | 
| 
         @@ -785,7 +831,7 @@ ensure the index immediately current before making a query request to the search 
     | 
|
| 
       785 
831 
     | 
    
         
             
            @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       786 
832 
     | 
    
         | 
| 
       787 
833 
     | 
    
         
             
             ### register(user_id, request) [](#method-i-register)
         
     | 
| 
       788 
     | 
    
         
            -
             Registers a user for an application. If you provide the User and the UserRegistration object on this request, it will create the user as well as register them for the application. This is called a Full Registration. However, if you only provide the UserRegistration object, then the user must already exist and they will be registered for the application. The user  
     | 
| 
      
 834 
     | 
    
         
            +
             Registers a user for an application. If you provide the User and the UserRegistration object on this request, it will create the user as well as register them for the application. This is called a Full Registration. However, if you only provide the UserRegistration object, then the user must already exist and they will be registered for the application. The user Id can also be provided and it will either be used to look up an existing user or it will be used for the newly created User.
         
     | 
| 
       789 
835 
     | 
    
         | 
| 
       790 
836 
     | 
    
         
             
            @param user\_id [string] (Optional) The Id of the user being registered for the application and optionally created. @param request [OpenStruct, Hash] The request that optionally contains the User and must contain the UserRegistration. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       791 
837 
     | 
    
         | 
| 
         @@ -799,7 +845,7 @@ You have been warned. 
     | 
|
| 
       799 
845 
     | 
    
         
             
             ### remove_user_from_family(family_id, user_id) [](#method-i-remove_user_from_family)
         
     | 
| 
       800 
846 
     | 
    
         
             
             Removes a user from the family with the given id.
         
     | 
| 
       801 
847 
     | 
    
         | 
| 
       802 
     | 
    
         
            -
            @param family\_id [string] The  
     | 
| 
      
 848 
     | 
    
         
            +
            @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. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       803 
849 
     | 
    
         | 
| 
       804 
850 
     | 
    
         
             
             ### resend_email_verification(email) [](#method-i-resend_email_verification)
         
     | 
| 
       805 
851 
     | 
    
         
             
             Re-sends the verification email to the user.
         
     | 
| 
         @@ -842,7 +888,7 @@ You have been warned. 
     | 
|
| 
       842 
888 
     | 
    
         
             
            @param key\_id [string] The Id of the API key to retrieve. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       843 
889 
     | 
    
         | 
| 
       844 
890 
     | 
    
         
             
             ### retrieve_application(application_id) [](#method-i-retrieve_application)
         
     | 
| 
       845 
     | 
    
         
            -
             Retrieves the application for the given  
     | 
| 
      
 891 
     | 
    
         
            +
             Retrieves the application for the given Id or all the applications if the Id is null.
         
     | 
| 
       846 
892 
     | 
    
         | 
| 
       847 
893 
     | 
    
         
             
            @param application\_id [string] (Optional) The application id. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       848 
894 
     | 
    
         | 
| 
         @@ -882,7 +928,7 @@ You have been warned. 
     | 
|
| 
       882 
928 
     | 
    
         
             
            @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.
         
     | 
| 
       883 
929 
     | 
    
         | 
| 
       884 
930 
     | 
    
         
             
             ### retrieve_email_template(email_template_id) [](#method-i-retrieve_email_template)
         
     | 
| 
       885 
     | 
    
         
            -
             Retrieves the email template for the given Id. If you don’t specify the id, this will return all  
     | 
| 
      
 931 
     | 
    
         
            +
             Retrieves the email template for the given Id. If you don’t specify the id, this will return all the email templates.
         
     | 
| 
       886 
932 
     | 
    
         | 
| 
       887 
933 
     | 
    
         
             
            @param email\_template\_id [string] (Optional) The Id of the email template. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       888 
934 
     | 
    
         | 
| 
         @@ -962,7 +1008,7 @@ You have been warned. 
     | 
|
| 
       962 
1008 
     | 
    
         
             
            @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       963 
1009 
     | 
    
         | 
| 
       964 
1010 
     | 
    
         
             
             ### retrieve_identity_provider(identity_provider_id) [](#method-i-retrieve_identity_provider)
         
     | 
| 
       965 
     | 
    
         
            -
             Retrieves the identity provider for the given  
     | 
| 
      
 1011 
     | 
    
         
            +
             Retrieves the identity provider for the given Id or all the identity providers if the Id is null.
         
     | 
| 
       966 
1012 
     | 
    
         | 
| 
       967 
1013 
     | 
    
         
             
            @param identity\_provider\_id [string] The identity provider Id. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       968 
1014 
     | 
    
         | 
| 
         @@ -1052,7 +1098,7 @@ You have been warned. 
     | 
|
| 
       1052 
1098 
     | 
    
         
             
            @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.
         
     | 
| 
       1053 
1099 
     | 
    
         | 
| 
       1054 
1100 
     | 
    
         
             
             ### retrieve_message_template(message_template_id) [](#method-i-retrieve_message_template)
         
     | 
| 
       1055 
     | 
    
         
            -
             Retrieves the message template for the given Id. If you don’t specify the id, this will return all  
     | 
| 
      
 1101 
     | 
    
         
            +
             Retrieves the message template for the given Id. If you don’t specify the id, this will return all the message templates.
         
     | 
| 
       1056 
1102 
     | 
    
         | 
| 
       1057 
1103 
     | 
    
         
             
            @param message\_template\_id [string] (Optional) The Id of the message template. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1058 
1104 
     | 
    
         | 
| 
         @@ -1110,6 +1156,11 @@ This API does not require an API key. 
     | 
|
| 
       1110 
1156 
     | 
    
         | 
| 
       1111 
1157 
     | 
    
         
             
            @param parent\_email [string] The email of the parent. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1112 
1158 
     | 
    
         | 
| 
      
 1159 
     | 
    
         
            +
             ### retrieve_pending_link(pending_link_id, user_id) [](#method-i-retrieve_pending_link)
         
     | 
| 
      
 1160 
     | 
    
         
            +
             Retrieve a pending identity provider link. This is useful to validate a pending link and retrieve meta-data about the identity provider link.
         
     | 
| 
      
 1161 
     | 
    
         
            +
             
     | 
| 
      
 1162 
     | 
    
         
            +
            @param p\_ending\_link\_id [string] The pending link Id. @param user\_id [string] The optional userId. When provided additional meta-data will be provided to identify how many links if any the user already has. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
      
 1163 
     | 
    
         
            +
             
     | 
| 
       1113 
1164 
     | 
    
         
             
             ### retrieve_reactor_metrics() [](#method-i-retrieve_reactor_metrics)
         
     | 
| 
       1114 
1165 
     | 
    
         
             
             Retrieves the [`FusionAuth`](../FusionAuth.html) Reactor metrics.
         
     | 
| 
       1115 
1166 
     | 
    
         | 
| 
         @@ -1136,7 +1187,7 @@ This API does not require an API key. 
     | 
|
| 
       1136 
1187 
     | 
    
         
             
            @param user\_id [string] The Id of the user. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1137 
1188 
     | 
    
         | 
| 
       1138 
1189 
     | 
    
         
             
             ### retrieve_registration(user_id, application_id) [](#method-i-retrieve_registration)
         
     | 
| 
       1139 
     | 
    
         
            -
             Retrieves the user registration for the user with the given  
     | 
| 
      
 1190 
     | 
    
         
            +
             Retrieves the user registration for the user with the given Id and the given application id.
         
     | 
| 
       1140 
1191 
     | 
    
         | 
| 
       1141 
1192 
     | 
    
         
             
            @param user\_id [string] The Id of the user. @param application\_id [string] The Id of the application. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1142 
1193 
     | 
    
         | 
| 
         @@ -1178,7 +1229,7 @@ This API does not require an API key. 
     | 
|
| 
       1178 
1229 
     | 
    
         
             
            @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1179 
1230 
     | 
    
         | 
| 
       1180 
1231 
     | 
    
         
             
             ### retrieve_total_report() [](#method-i-retrieve_total_report)
         
     | 
| 
       1181 
     | 
    
         
            -
             Retrieves the totals report. This contains all  
     | 
| 
      
 1232 
     | 
    
         
            +
             Retrieves the totals report. This contains all the total counts for each application and the global registration count.
         
     | 
| 
       1182 
1233 
     | 
    
         | 
| 
       1183 
1234 
     | 
    
         
             
            @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1184 
1235 
     | 
    
         | 
| 
         @@ -1200,12 +1251,12 @@ This can be used to see if a user will need to complete a two-factor challenge t 
     | 
|
| 
       1200 
1251 
     | 
    
         
             
            @param user\_id [string] The Id of the user. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1201 
1252 
     | 
    
         | 
| 
       1202 
1253 
     | 
    
         
             
             ### retrieve_user_action(user_action_id) [](#method-i-retrieve_user_action)
         
     | 
| 
       1203 
     | 
    
         
            -
             Retrieves the user action for the given Id. If you pass in null for the id, this will return all  
     | 
| 
      
 1254 
     | 
    
         
            +
             Retrieves the user action for the given Id. If you pass in null for the id, this will return all the user actions.
         
     | 
| 
       1204 
1255 
     | 
    
         | 
| 
       1205 
1256 
     | 
    
         
             
            @param user\_action\_id [string] (Optional) The Id of the user action. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1206 
1257 
     | 
    
         | 
| 
       1207 
1258 
     | 
    
         
             
             ### retrieve_user_action_reason(user_action_reason_id) [](#method-i-retrieve_user_action_reason)
         
     | 
| 
       1208 
     | 
    
         
            -
             Retrieves the user action reason for the given Id. If you pass in null for the id, this will return all  
     | 
| 
      
 1259 
     | 
    
         
            +
             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.
         
     | 
| 
       1209 
1260 
     | 
    
         | 
| 
       1210 
1261 
     | 
    
         
             
            @param user\_action\_reason\_id [string] (Optional) The Id of the user action reason. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1211 
1262 
     | 
    
         | 
| 
         @@ -1244,6 +1295,22 @@ This can be used to see if a user will need to complete a two-factor challenge t 
     | 
|
| 
       1244 
1295 
     | 
    
         | 
| 
       1245 
1296 
     | 
    
         
             
            @param verification\_id [string] The unique verification Id that has been set on the user object. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1246 
1297 
     | 
    
         | 
| 
      
 1298 
     | 
    
         
            +
             ### retrieve_user_code(client_id, client_secret, user_code) [](#method-i-retrieve_user_code)
         
     | 
| 
      
 1299 
     | 
    
         
            +
             Retrieve a user\_code that is part of an in-progress Device Authorization Grant.
         
     | 
| 
      
 1300 
     | 
    
         
            +
             
     | 
| 
      
 1301 
     | 
    
         
            +
            This API is useful if you want to build your own login workflow to complete a device grant.
         
     | 
| 
      
 1302 
     | 
    
         
            +
             
     | 
| 
      
 1303 
     | 
    
         
            +
            @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.
         
     | 
| 
      
 1304 
     | 
    
         
            +
             
     | 
| 
      
 1305 
     | 
    
         
            +
             ### retrieve_user_code_using_api_key(user_code) [](#method-i-retrieve_user_code_using_api_key)
         
     | 
| 
      
 1306 
     | 
    
         
            +
             Retrieve a user\_code that is part of an in-progress Device Authorization Grant.
         
     | 
| 
      
 1307 
     | 
    
         
            +
             
     | 
| 
      
 1308 
     | 
    
         
            +
            This API is useful if you want to build your own login workflow to complete a device grant.
         
     | 
| 
      
 1309 
     | 
    
         
            +
             
     | 
| 
      
 1310 
     | 
    
         
            +
            This request will require an API key.
         
     | 
| 
      
 1311 
     | 
    
         
            +
             
     | 
| 
      
 1312 
     | 
    
         
            +
            @param user\_code [string] The end-user verification code. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
      
 1313 
     | 
    
         
            +
             
     | 
| 
       1247 
1314 
     | 
    
         
             
             ### retrieve_user_comments(user_id) [](#method-i-retrieve_user_comments)
         
     | 
| 
       1248 
1315 
     | 
    
         
             
             Retrieves all the comments for the user with the given Id.
         
     | 
| 
       1249 
1316 
     | 
    
         | 
| 
         @@ -1346,7 +1413,7 @@ See also: (method names may vary by language… but you’ll figure it out) 
     | 
|
| 
       1346 
1413 
     | 
    
         
             
            -revokeRefreshTokenById-revokeRefreshTokenByToken-revokeRefreshTokensByUserId-revokeRefreshTokensByApplicationId-revokeRefreshTokensByUserIdForApplication
         
     | 
| 
       1347 
1414 
     | 
    
         
             
            ```
         
     | 
| 
       1348 
1415 
     | 
    
         | 
| 
       1349 
     | 
    
         
            -
            @param token [string] (Optional) The refresh token to delete. @param user\_id [string] (Optional) The user  
     | 
| 
      
 1416 
     | 
    
         
            +
            @param token [string] (Optional) The refresh token to delete. @param user\_id [string] (Optional) The user Id whose tokens to delete. @param application\_id [string] (Optional) The application Id of the tokens to delete. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1350 
1417 
     | 
    
         | 
| 
       1351 
1418 
     | 
    
         
             
             ### revoke_refresh_token_by_id(token_id) [](#method-i-revoke_refresh_token_by_id)
         
     | 
| 
       1352 
1419 
     | 
    
         
             
             Revokes a single refresh token by the unique Id. The unique Id is not sensitive as it cannot be used to obtain another JWT.
         
     | 
| 
         @@ -1383,9 +1450,24 @@ See also: (method names may vary by language… but you’ll figure it out) 
     | 
|
| 
       1383 
1450 
     | 
    
         | 
| 
       1384 
1451 
     | 
    
         
             
            @param user\_consent\_id [string] The User Consent Id @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1385 
1452 
     | 
    
         | 
| 
      
 1453 
     | 
    
         
            +
             ### search_applications(request) [](#method-i-search_applications)
         
     | 
| 
      
 1454 
     | 
    
         
            +
             Searches applications with the specified criteria and pagination.
         
     | 
| 
      
 1455 
     | 
    
         
            +
             
     | 
| 
      
 1456 
     | 
    
         
            +
            @param request [OpenStruct, Hash] The search criteria and pagination information. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
      
 1457 
     | 
    
         
            +
             
     | 
| 
       1386 
1458 
     | 
    
         
             
             ### search_audit_logs(request) [](#method-i-search_audit_logs)
         
     | 
| 
       1387 
1459 
     | 
    
         
             
             Searches the audit logs with the specified criteria and pagination.
         
     | 
| 
       1388 
1460 
     | 
    
         | 
| 
      
 1461 
     | 
    
         
            +
            @param request [OpenStruct, Hash] The search criteria and pagination information. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
      
 1462 
     | 
    
         
            +
             
     | 
| 
      
 1463 
     | 
    
         
            +
             ### search_consents(request) [](#method-i-search_consents)
         
     | 
| 
      
 1464 
     | 
    
         
            +
             Searches consents with the specified criteria and pagination.
         
     | 
| 
      
 1465 
     | 
    
         
            +
             
     | 
| 
      
 1466 
     | 
    
         
            +
            @param request [OpenStruct, Hash] The search criteria and pagination information. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
      
 1467 
     | 
    
         
            +
             
     | 
| 
      
 1468 
     | 
    
         
            +
             ### search_email_templates(request) [](#method-i-search_email_templates)
         
     | 
| 
      
 1469 
     | 
    
         
            +
             Searches email templates with the specified criteria and pagination.
         
     | 
| 
      
 1470 
     | 
    
         
            +
             
     | 
| 
       1389 
1471 
     | 
    
         
             
            @param request [OpenStruct, Hash] The search criteria and pagination information. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1390 
1472 
     | 
    
         | 
| 
       1391 
1473 
     | 
    
         
             
             ### search_entities(request) [](#method-i-search_entities)
         
     | 
| 
         @@ -1394,7 +1476,7 @@ See also: (method names may vary by language… but you’ll figure it out) 
     | 
|
| 
       1394 
1476 
     | 
    
         
             
            @param request [OpenStruct, Hash] The search criteria and pagination information. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1395 
1477 
     | 
    
         | 
| 
       1396 
1478 
     | 
    
         
             
             ### search_entities_by_ids(ids) [](#method-i-search_entities_by_ids)
         
     | 
| 
       1397 
     | 
    
         
            -
             Retrieves the entities for the given ids. If any  
     | 
| 
      
 1479 
     | 
    
         
            +
             Retrieves the entities for the given ids. If any Id is invalid, it is ignored.
         
     | 
| 
       1398 
1480 
     | 
    
         | 
| 
       1399 
1481 
     | 
    
         
             
            @param ids [Array] The entity ids to search for. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1400 
1482 
     | 
    
         | 
| 
         @@ -1421,25 +1503,55 @@ See also: (method names may vary by language… but you’ll figure it out) 
     | 
|
| 
       1421 
1503 
     | 
    
         
             
             ### search_groups(request) [](#method-i-search_groups)
         
     | 
| 
       1422 
1504 
     | 
    
         
             
             Searches groups with the specified criteria and pagination.
         
     | 
| 
       1423 
1505 
     | 
    
         | 
| 
      
 1506 
     | 
    
         
            +
            @param request [OpenStruct, Hash] The search criteria and pagination information. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
      
 1507 
     | 
    
         
            +
             
     | 
| 
      
 1508 
     | 
    
         
            +
             ### search_identity_providers(request) [](#method-i-search_identity_providers)
         
     | 
| 
      
 1509 
     | 
    
         
            +
             Searches identity providers with the specified criteria and pagination.
         
     | 
| 
      
 1510 
     | 
    
         
            +
             
     | 
| 
       1424 
1511 
     | 
    
         
             
            @param request [OpenStruct, Hash] The search criteria and pagination information. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1425 
1512 
     | 
    
         | 
| 
       1426 
1513 
     | 
    
         
             
             ### search_ip_access_control_lists(request) [](#method-i-search_ip_access_control_lists)
         
     | 
| 
       1427 
1514 
     | 
    
         
             
             Searches the IP Access Control Lists with the specified criteria and pagination.
         
     | 
| 
       1428 
1515 
     | 
    
         | 
| 
      
 1516 
     | 
    
         
            +
            @param request [OpenStruct, Hash] The search criteria and pagination information. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
      
 1517 
     | 
    
         
            +
             
     | 
| 
      
 1518 
     | 
    
         
            +
             ### search_keys(request) [](#method-i-search_keys)
         
     | 
| 
      
 1519 
     | 
    
         
            +
             Searches keys with the specified criteria and pagination.
         
     | 
| 
      
 1520 
     | 
    
         
            +
             
     | 
| 
      
 1521 
     | 
    
         
            +
            @param request [OpenStruct, Hash] The search criteria and pagination information. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
      
 1522 
     | 
    
         
            +
             
     | 
| 
      
 1523 
     | 
    
         
            +
             ### search_lambdas(request) [](#method-i-search_lambdas)
         
     | 
| 
      
 1524 
     | 
    
         
            +
             Searches lambdas with the specified criteria and pagination.
         
     | 
| 
      
 1525 
     | 
    
         
            +
             
     | 
| 
       1429 
1526 
     | 
    
         
             
            @param request [OpenStruct, Hash] The search criteria and pagination information. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1430 
1527 
     | 
    
         | 
| 
       1431 
1528 
     | 
    
         
             
             ### search_login_records(request) [](#method-i-search_login_records)
         
     | 
| 
       1432 
1529 
     | 
    
         
             
             Searches the login records with the specified criteria and pagination.
         
     | 
| 
       1433 
1530 
     | 
    
         | 
| 
      
 1531 
     | 
    
         
            +
            @param request [OpenStruct, Hash] The search criteria and pagination information. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
      
 1532 
     | 
    
         
            +
             
     | 
| 
      
 1533 
     | 
    
         
            +
             ### search_tenants(request) [](#method-i-search_tenants)
         
     | 
| 
      
 1534 
     | 
    
         
            +
             Searches tenants with the specified criteria and pagination.
         
     | 
| 
      
 1535 
     | 
    
         
            +
             
     | 
| 
      
 1536 
     | 
    
         
            +
            @param request [OpenStruct, Hash] The search criteria and pagination information. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
      
 1537 
     | 
    
         
            +
             
     | 
| 
      
 1538 
     | 
    
         
            +
             ### search_themes(request) [](#method-i-search_themes)
         
     | 
| 
      
 1539 
     | 
    
         
            +
             Searches themes with the specified criteria and pagination.
         
     | 
| 
      
 1540 
     | 
    
         
            +
             
     | 
| 
      
 1541 
     | 
    
         
            +
            @param request [OpenStruct, Hash] The search criteria and pagination information. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
      
 1542 
     | 
    
         
            +
             
     | 
| 
      
 1543 
     | 
    
         
            +
             ### search_user_comments(request) [](#method-i-search_user_comments)
         
     | 
| 
      
 1544 
     | 
    
         
            +
             Searches user comments with the specified criteria and pagination.
         
     | 
| 
      
 1545 
     | 
    
         
            +
             
     | 
| 
       1434 
1546 
     | 
    
         
             
            @param request [OpenStruct, Hash] The search criteria and pagination information. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1435 
1547 
     | 
    
         | 
| 
       1436 
1548 
     | 
    
         
             
             ### search_users(ids) [](#method-i-search_users)
         
     | 
| 
       1437 
     | 
    
         
            -
             Retrieves the users for the given ids. If any  
     | 
| 
      
 1549 
     | 
    
         
            +
             Retrieves the users for the given ids. If any Id is invalid, it is ignored.
         
     | 
| 
       1438 
1550 
     | 
    
         | 
| 
       1439 
1551 
     | 
    
         
             
            @param ids [Array] The user ids to search for. @return [FusionAuth::ClientResponse] The ClientResponse object. @deprecated This method has been renamed to [`search_users_by_ids`](FusionAuthClient.html#method-i-search_users_by_ids), use that method instead.
         
     | 
| 
       1440 
1552 
     | 
    
         | 
| 
       1441 
1553 
     | 
    
         
             
             ### search_users_by_ids(ids) [](#method-i-search_users_by_ids)
         
     | 
| 
       1442 
     | 
    
         
            -
             Retrieves the users for the given ids. If any  
     | 
| 
      
 1554 
     | 
    
         
            +
             Retrieves the users for the given ids. If any Id is invalid, it is ignored.
         
     | 
| 
       1443 
1555 
     | 
    
         | 
| 
       1444 
1556 
     | 
    
         
             
            @param ids [Array] The user ids to search for. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1445 
1557 
     | 
    
         | 
| 
         @@ -1465,10 +1577,15 @@ and sortFields. 
     | 
|
| 
       1465 
1577 
     | 
    
         | 
| 
       1466 
1578 
     | 
    
         
             
            @return [FusionAuth::ClientResponse] The ClientResponse object. @deprecated This method has been renamed to [`search_users_by_query`](FusionAuthClient.html#method-i-search_users_by_query), use that method instead.
         
     | 
| 
       1467 
1579 
     | 
    
         | 
| 
      
 1580 
     | 
    
         
            +
             ### search_webhooks(request) [](#method-i-search_webhooks)
         
     | 
| 
      
 1581 
     | 
    
         
            +
             Searches webhooks with the specified criteria and pagination.
         
     | 
| 
      
 1582 
     | 
    
         
            +
             
     | 
| 
      
 1583 
     | 
    
         
            +
            @param request [OpenStruct, Hash] The search criteria and pagination information. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
      
 1584 
     | 
    
         
            +
             
     | 
| 
       1468 
1585 
     | 
    
         
             
             ### send_email(email_template_id, request) [](#method-i-send_email)
         
     | 
| 
       1469 
1586 
     | 
    
         
             
             Send an email using an email template id. You can optionally provide `requestData` to access key value pairs in the email template.
         
     | 
| 
       1470 
1587 
     | 
    
         | 
| 
       1471 
     | 
    
         
            -
            @param email\_template\_id [string] The  
     | 
| 
      
 1588 
     | 
    
         
            +
            @param email\_template\_id [string] The Id for the template. @param request [OpenStruct, Hash] The send email request that contains all the information used to send the email. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1472 
1589 
     | 
    
         | 
| 
       1473 
1590 
     | 
    
         
             
             ### send_family_request_email(request) [](#method-i-send_family_request_email)
         
     | 
| 
       1474 
1591 
     | 
    
         
             
             Sends out an email to a parent that they need to register and create a family or need to log in and add a child to their existing family.
         
     | 
| 
         @@ -1478,7 +1595,7 @@ and sortFields. 
     | 
|
| 
       1478 
1595 
     | 
    
         
             
             ### send_passwordless_code(request) [](#method-i-send_passwordless_code)
         
     | 
| 
       1479 
1596 
     | 
    
         
             
             Send a passwordless authentication code in an email to complete login.
         
     | 
| 
       1480 
1597 
     | 
    
         | 
| 
       1481 
     | 
    
         
            -
            @param request [OpenStruct, Hash] The passwordless send request that contains all  
     | 
| 
      
 1598 
     | 
    
         
            +
            @param request [OpenStruct, Hash] The passwordless send request that contains all the information used to send an email containing a code. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1482 
1599 
     | 
    
         | 
| 
       1483 
1600 
     | 
    
         
             
             ### send_two_factor_code(request) [](#method-i-send_two_factor_code)
         
     | 
| 
       1484 
1601 
     | 
    
         
             
             Send a Two Factor authentication code to assist in setting up Two Factor authentication or disabling.
         
     | 
| 
         @@ -1498,7 +1615,7 @@ and sortFields. 
     | 
|
| 
       1498 
1615 
     | 
    
         
             
             ### send_two_factor_code_for_login_using_method(two_factor_id, request) [](#method-i-send_two_factor_code_for_login_using_method)
         
     | 
| 
       1499 
1616 
     | 
    
         
             
             Send a Two Factor authentication code to allow the completion of Two Factor authentication.
         
     | 
| 
       1500 
1617 
     | 
    
         | 
| 
       1501 
     | 
    
         
            -
            @param two\_factor\_id [string] The Id returned by the Login API necessary to complete Two Factor authentication. @param request [OpenStruct, Hash] The Two Factor send request that contains all  
     | 
| 
      
 1618 
     | 
    
         
            +
            @param two\_factor\_id [string] The Id returned by the Login API necessary to complete Two Factor authentication. @param request [OpenStruct, Hash] The Two Factor send request that contains all the information used to send the Two Factor code to the user. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1502 
1619 
     | 
    
         | 
| 
       1503 
1620 
     | 
    
         
             
             ### set_tenant_id(tenant_id) [](#method-i-set_tenant_id)
         
     | 
| 
       1504 
1621 
     | 
    
         
             
             ### start_identity_provider_login(request) [](#method-i-start_identity_provider_login)
         
     | 
| 
         @@ -1515,14 +1632,14 @@ providers that FusionAuth uses to reconcile the user's account. 
     | 
|
| 
       1515 
1632 
     | 
    
         
             
             ### start_passwordless_login(request) [](#method-i-start_passwordless_login)
         
     | 
| 
       1516 
1633 
     | 
    
         
             
             Start a passwordless login request by generating a passwordless code. This code can be sent to the User using the Send Passwordless Code API or using a mechanism outside of [`FusionAuth`](../FusionAuth.html). The passwordless login is completed by using the Passwordless Login API with this code.
         
     | 
| 
       1517 
1634 
     | 
    
         | 
| 
       1518 
     | 
    
         
            -
            @param request [OpenStruct, Hash] The passwordless start request that contains all  
     | 
| 
      
 1635 
     | 
    
         
            +
            @param request [OpenStruct, Hash] The passwordless start request that contains all the information used to begin the passwordless login request. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1519 
1636 
     | 
    
         | 
| 
       1520 
1637 
     | 
    
         
             
             ### start_two_factor_login(request) [](#method-i-start_two_factor_login)
         
     | 
| 
       1521 
1638 
     | 
    
         
             
             Start a Two-Factor login request by generating a two-factor identifier. This code can then be sent to the Two Factor Send API (/api/two-factor/send)in order to send a one-time use code to a user. You can also use one-time use code returned to send the code out-of-band. The Two-Factor login is completed by making a request to the Two-Factor Login API (/api/two-factor/login). with the two-factor identifier and the one-time use code.
         
     | 
| 
       1522 
1639 
     | 
    
         | 
| 
       1523 
     | 
    
         
            -
            This API is intended to allow you to begin a Two-Factor login outside  
     | 
| 
      
 1640 
     | 
    
         
            +
            This API is intended to allow you to begin a Two-Factor login outside a normal login that originated from the Login API (/api/login).
         
     | 
| 
       1524 
1641 
     | 
    
         | 
| 
       1525 
     | 
    
         
            -
            @param request [OpenStruct, Hash] The Two-Factor start request that contains all  
     | 
| 
      
 1642 
     | 
    
         
            +
            @param request [OpenStruct, Hash] The Two-Factor start request that contains all the information used to begin the Two-Factor login request. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1526 
1643 
     | 
    
         | 
| 
       1527 
1644 
     | 
    
         
             
             ### start_web_authn_login(request) [](#method-i-start_web_authn_login)
         
     | 
| 
       1528 
1645 
     | 
    
         
             
             Start a WebAuthn authentication ceremony by generating a new challenge for the user
         
     | 
| 
         @@ -1547,57 +1664,57 @@ This API is intended to allow you to begin a Two-Factor login outside of a norma 
     | 
|
| 
       1547 
1664 
     | 
    
         
             
             ### update_application(application_id, request) [](#method-i-update_application)
         
     | 
| 
       1548 
1665 
     | 
    
         
             
             Updates the application with the given Id.
         
     | 
| 
       1549 
1666 
     | 
    
         | 
| 
       1550 
     | 
    
         
            -
            @param application\_id [string] The Id of the application to update. @param request [OpenStruct, Hash] The request that contains all  
     | 
| 
      
 1667 
     | 
    
         
            +
            @param application\_id [string] The Id of the application to update. @param request [OpenStruct, Hash] The request that contains all the new application information. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1551 
1668 
     | 
    
         | 
| 
       1552 
1669 
     | 
    
         
             
             ### update_application_role(application_id, role_id, request) [](#method-i-update_application_role)
         
     | 
| 
       1553 
     | 
    
         
            -
             Updates the application role with the given  
     | 
| 
      
 1670 
     | 
    
         
            +
             Updates the application role with the given Id for the application.
         
     | 
| 
       1554 
1671 
     | 
    
         | 
| 
       1555 
     | 
    
         
            -
            @param application\_id [string] The Id of the application that the role belongs to. @param role\_id [string] The Id of the role to update. @param request [OpenStruct, Hash] The request that contains all  
     | 
| 
      
 1672 
     | 
    
         
            +
            @param application\_id [string] The Id of the application that the role belongs to. @param role\_id [string] The Id of the role to update. @param request [OpenStruct, Hash] The request that contains all the new role information. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1556 
1673 
     | 
    
         | 
| 
       1557 
1674 
     | 
    
         
             
             ### update_connector(connector_id, request) [](#method-i-update_connector)
         
     | 
| 
       1558 
1675 
     | 
    
         
             
             Updates the connector with the given Id.
         
     | 
| 
       1559 
1676 
     | 
    
         | 
| 
       1560 
     | 
    
         
            -
            @param connector\_id [string] The Id of the connector to update. @param request [OpenStruct, Hash] The request object that contains all  
     | 
| 
      
 1677 
     | 
    
         
            +
            @param connector\_id [string] The Id of the connector to update. @param request [OpenStruct, Hash] The request object that contains all the new connector information. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1561 
1678 
     | 
    
         | 
| 
       1562 
1679 
     | 
    
         
             
             ### update_consent(consent_id, request) [](#method-i-update_consent)
         
     | 
| 
       1563 
1680 
     | 
    
         
             
             Updates the consent with the given Id.
         
     | 
| 
       1564 
1681 
     | 
    
         | 
| 
       1565 
     | 
    
         
            -
            @param consent\_id [string] The Id of the consent to update. @param request [OpenStruct, Hash] The request that contains all  
     | 
| 
      
 1682 
     | 
    
         
            +
            @param consent\_id [string] The Id of the consent to update. @param request [OpenStruct, Hash] The request that contains all the new consent information. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1566 
1683 
     | 
    
         | 
| 
       1567 
1684 
     | 
    
         
             
             ### update_email_template(email_template_id, request) [](#method-i-update_email_template)
         
     | 
| 
       1568 
1685 
     | 
    
         
             
             Updates the email template with the given Id.
         
     | 
| 
       1569 
1686 
     | 
    
         | 
| 
       1570 
     | 
    
         
            -
            @param email\_template\_id [string] The Id of the email template to update. @param request [OpenStruct, Hash] The request that contains all  
     | 
| 
      
 1687 
     | 
    
         
            +
            @param email\_template\_id [string] The Id of the email template to update. @param request [OpenStruct, Hash] The request that contains all the new email template information. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1571 
1688 
     | 
    
         | 
| 
       1572 
1689 
     | 
    
         
             
             ### update_entity(entity_id, request) [](#method-i-update_entity)
         
     | 
| 
       1573 
1690 
     | 
    
         
             
             Updates the Entity with the given Id.
         
     | 
| 
       1574 
1691 
     | 
    
         | 
| 
       1575 
     | 
    
         
            -
            @param entity\_id [string] The Id of the Entity to update. @param request [OpenStruct, Hash] The request that contains all  
     | 
| 
      
 1692 
     | 
    
         
            +
            @param entity\_id [string] The Id of the Entity to update. @param request [OpenStruct, Hash] The request that contains all the new Entity information. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1576 
1693 
     | 
    
         | 
| 
       1577 
1694 
     | 
    
         
             
             ### update_entity_type(entity_type_id, request) [](#method-i-update_entity_type)
         
     | 
| 
       1578 
1695 
     | 
    
         
             
             Updates the Entity Type with the given Id.
         
     | 
| 
       1579 
1696 
     | 
    
         | 
| 
       1580 
     | 
    
         
            -
            @param entity\_type\_id [string] The Id of the Entity Type to update. @param request [OpenStruct, Hash] The request that contains all  
     | 
| 
      
 1697 
     | 
    
         
            +
            @param entity\_type\_id [string] The Id of the Entity Type to update. @param request [OpenStruct, Hash] The request that contains all the new Entity Type information. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1581 
1698 
     | 
    
         | 
| 
       1582 
1699 
     | 
    
         
             
             ### update_entity_type_permission(entity_type_id, permission_id, request) [](#method-i-update_entity_type_permission)
         
     | 
| 
       1583 
     | 
    
         
            -
             Updates the permission with the given  
     | 
| 
      
 1700 
     | 
    
         
            +
             Updates the permission with the given Id for the entity type.
         
     | 
| 
       1584 
1701 
     | 
    
         | 
| 
       1585 
     | 
    
         
            -
            @param entity\_type\_id [string] The Id of the entityType that the permission belongs to. @param permission\_id [string] The Id of the permission to update. @param request [OpenStruct, Hash] The request that contains all  
     | 
| 
      
 1702 
     | 
    
         
            +
            @param entity\_type\_id [string] The Id of the entityType that the permission belongs to. @param permission\_id [string] The Id of the permission to update. @param request [OpenStruct, Hash] The request that contains all the new permission information. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1586 
1703 
     | 
    
         | 
| 
       1587 
1704 
     | 
    
         
             
             ### update_form(form_id, request) [](#method-i-update_form)
         
     | 
| 
       1588 
1705 
     | 
    
         
             
             Updates the form with the given Id.
         
     | 
| 
       1589 
1706 
     | 
    
         | 
| 
       1590 
     | 
    
         
            -
            @param form\_id [string] The Id of the form to update. @param request [OpenStruct, Hash] The request object that contains all  
     | 
| 
      
 1707 
     | 
    
         
            +
            @param form\_id [string] The Id of the form to update. @param request [OpenStruct, Hash] The request object that contains all the new form information. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1591 
1708 
     | 
    
         | 
| 
       1592 
1709 
     | 
    
         
             
             ### update_form_field(field_id, request) [](#method-i-update_form_field)
         
     | 
| 
       1593 
1710 
     | 
    
         
             
             Updates the form field with the given Id.
         
     | 
| 
       1594 
1711 
     | 
    
         | 
| 
       1595 
     | 
    
         
            -
            @param field\_id [string] The Id of the form field to update. @param request [OpenStruct, Hash] The request object that contains all  
     | 
| 
      
 1712 
     | 
    
         
            +
            @param field\_id [string] The Id of the form field to update. @param request [OpenStruct, Hash] The request object that contains all the new form field information. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1596 
1713 
     | 
    
         | 
| 
       1597 
1714 
     | 
    
         
             
             ### update_group(group_id, request) [](#method-i-update_group)
         
     | 
| 
       1598 
1715 
     | 
    
         
             
             Updates the group with the given Id.
         
     | 
| 
       1599 
1716 
     | 
    
         | 
| 
       1600 
     | 
    
         
            -
            @param group\_id [string] The Id of the group to update. @param request [OpenStruct, Hash] The request that contains all  
     | 
| 
      
 1717 
     | 
    
         
            +
            @param group\_id [string] The Id of the group to update. @param request [OpenStruct, Hash] The request that contains all the new group information. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1601 
1718 
     | 
    
         | 
| 
       1602 
1719 
     | 
    
         
             
             ### update_group_members(request) [](#method-i-update_group_members)
         
     | 
| 
       1603 
1720 
     | 
    
         
             
             Creates a member in a group.
         
     | 
| 
         @@ -1612,67 +1729,67 @@ This API is intended to allow you to begin a Two-Factor login outside of a norma 
     | 
|
| 
       1612 
1729 
     | 
    
         
             
             ### update_integrations(request) [](#method-i-update_integrations)
         
     | 
| 
       1613 
1730 
     | 
    
         
             
             Updates the available integrations.
         
     | 
| 
       1614 
1731 
     | 
    
         | 
| 
       1615 
     | 
    
         
            -
            @param request [OpenStruct, Hash] The request that contains all  
     | 
| 
      
 1732 
     | 
    
         
            +
            @param request [OpenStruct, Hash] The request that contains all the new integration information. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1616 
1733 
     | 
    
         | 
| 
       1617 
1734 
     | 
    
         
             
             ### update_ip_access_control_list(access_control_list_id, request) [](#method-i-update_ip_access_control_list)
         
     | 
| 
       1618 
1735 
     | 
    
         
             
             Updates the IP Access Control List with the given Id.
         
     | 
| 
       1619 
1736 
     | 
    
         | 
| 
       1620 
     | 
    
         
            -
            @param access\_control\_list\_id [string] The Id of the IP Access Control List to update. @param request [OpenStruct, Hash] The request that contains all  
     | 
| 
      
 1737 
     | 
    
         
            +
            @param access\_control\_list\_id [string] The Id of the IP Access Control List to update. @param request [OpenStruct, Hash] The request that contains all the new IP Access Control List information. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1621 
1738 
     | 
    
         | 
| 
       1622 
1739 
     | 
    
         
             
             ### update_key(key_id, request) [](#method-i-update_key)
         
     | 
| 
       1623 
1740 
     | 
    
         
             
             Updates the key with the given Id.
         
     | 
| 
       1624 
1741 
     | 
    
         | 
| 
       1625 
     | 
    
         
            -
            @param key\_id [string] The Id of the key to update. @param request [OpenStruct, Hash] The request that contains all  
     | 
| 
      
 1742 
     | 
    
         
            +
            @param key\_id [string] The Id of the key to update. @param request [OpenStruct, Hash] The request that contains all the new key information. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1626 
1743 
     | 
    
         | 
| 
       1627 
1744 
     | 
    
         
             
             ### update_lambda(lambda_id, request) [](#method-i-update_lambda)
         
     | 
| 
       1628 
1745 
     | 
    
         
             
             Updates the lambda with the given Id.
         
     | 
| 
       1629 
1746 
     | 
    
         | 
| 
       1630 
     | 
    
         
            -
            @param lambda\_id [string] The Id of the lambda to update. @param request [OpenStruct, Hash] The request that contains all  
     | 
| 
      
 1747 
     | 
    
         
            +
            @param lambda\_id [string] The Id of the lambda to update. @param request [OpenStruct, Hash] The request that contains all the new lambda information. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1631 
1748 
     | 
    
         | 
| 
       1632 
1749 
     | 
    
         
             
             ### update_message_template(message_template_id, request) [](#method-i-update_message_template)
         
     | 
| 
       1633 
1750 
     | 
    
         
             
             Updates the message template with the given Id.
         
     | 
| 
       1634 
1751 
     | 
    
         | 
| 
       1635 
     | 
    
         
            -
            @param message\_template\_id [string] The Id of the message template to update. @param request [OpenStruct, Hash] The request that contains all  
     | 
| 
      
 1752 
     | 
    
         
            +
            @param message\_template\_id [string] The Id of the message template to update. @param request [OpenStruct, Hash] The request that contains all the new message template information. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1636 
1753 
     | 
    
         | 
| 
       1637 
1754 
     | 
    
         
             
             ### update_messenger(messenger_id, request) [](#method-i-update_messenger)
         
     | 
| 
       1638 
1755 
     | 
    
         
             
             Updates the messenger with the given Id.
         
     | 
| 
       1639 
1756 
     | 
    
         | 
| 
       1640 
     | 
    
         
            -
            @param messenger\_id [string] The Id of the messenger to update. @param request [OpenStruct, Hash] The request object that contains all  
     | 
| 
      
 1757 
     | 
    
         
            +
            @param messenger\_id [string] The Id of the messenger to update. @param request [OpenStruct, Hash] The request object that contains all the new messenger information. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1641 
1758 
     | 
    
         | 
| 
       1642 
1759 
     | 
    
         
             
             ### update_registration(user_id, request) [](#method-i-update_registration)
         
     | 
| 
       1643 
     | 
    
         
            -
             Updates the registration for the user with the given  
     | 
| 
      
 1760 
     | 
    
         
            +
             Updates the registration for the user with the given Id and the application defined in the request.
         
     | 
| 
       1644 
1761 
     | 
    
         | 
| 
       1645 
     | 
    
         
            -
            @param user\_id [string] The Id of the user whose registration is going to be updated. @param request [OpenStruct, Hash] The request that contains all  
     | 
| 
      
 1762 
     | 
    
         
            +
            @param user\_id [string] The Id of the user whose registration is going to be updated. @param request [OpenStruct, Hash] The request that contains all the new registration information. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1646 
1763 
     | 
    
         | 
| 
       1647 
1764 
     | 
    
         
             
             ### update_system_configuration(request) [](#method-i-update_system_configuration)
         
     | 
| 
       1648 
1765 
     | 
    
         
             
             Updates the system configuration.
         
     | 
| 
       1649 
1766 
     | 
    
         | 
| 
       1650 
     | 
    
         
            -
            @param request [OpenStruct, Hash] The request that contains all  
     | 
| 
      
 1767 
     | 
    
         
            +
            @param request [OpenStruct, Hash] The request that contains all the new system configuration information. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1651 
1768 
     | 
    
         | 
| 
       1652 
1769 
     | 
    
         
             
             ### update_tenant(tenant_id, request) [](#method-i-update_tenant)
         
     | 
| 
       1653 
1770 
     | 
    
         
             
             Updates the tenant with the given Id.
         
     | 
| 
       1654 
1771 
     | 
    
         | 
| 
       1655 
     | 
    
         
            -
            @param [`tenant_id`](FusionAuthClient.html#attribute-i-tenant_id) [string] The Id of the tenant to update. @param request [OpenStruct, Hash] The request that contains all  
     | 
| 
      
 1772 
     | 
    
         
            +
            @param [`tenant_id`](FusionAuthClient.html#attribute-i-tenant_id) [string] The Id of the tenant to update. @param request [OpenStruct, Hash] The request that contains all the new tenant information. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1656 
1773 
     | 
    
         | 
| 
       1657 
1774 
     | 
    
         
             
             ### update_theme(theme_id, request) [](#method-i-update_theme)
         
     | 
| 
       1658 
1775 
     | 
    
         
             
             Updates the theme with the given Id.
         
     | 
| 
       1659 
1776 
     | 
    
         | 
| 
       1660 
     | 
    
         
            -
            @param theme\_id [string] The Id of the theme to update. @param request [OpenStruct, Hash] The request that contains all  
     | 
| 
      
 1777 
     | 
    
         
            +
            @param theme\_id [string] The Id of the theme to update. @param request [OpenStruct, Hash] The request that contains all the new theme information. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1661 
1778 
     | 
    
         | 
| 
       1662 
1779 
     | 
    
         
             
             ### update_user(user_id, request) [](#method-i-update_user)
         
     | 
| 
       1663 
1780 
     | 
    
         
             
             Updates the user with the given Id.
         
     | 
| 
       1664 
1781 
     | 
    
         | 
| 
       1665 
     | 
    
         
            -
            @param user\_id [string] The Id of the user to update. @param request [OpenStruct, Hash] The request that contains all  
     | 
| 
      
 1782 
     | 
    
         
            +
            @param user\_id [string] The Id of the user to update. @param request [OpenStruct, Hash] The request that contains all the new user information. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1666 
1783 
     | 
    
         | 
| 
       1667 
1784 
     | 
    
         
             
             ### update_user_action(user_action_id, request) [](#method-i-update_user_action)
         
     | 
| 
       1668 
1785 
     | 
    
         
             
             Updates the user action with the given Id.
         
     | 
| 
       1669 
1786 
     | 
    
         | 
| 
       1670 
     | 
    
         
            -
            @param user\_action\_id [string] The Id of the user action to update. @param request [OpenStruct, Hash] The request that contains all  
     | 
| 
      
 1787 
     | 
    
         
            +
            @param user\_action\_id [string] The Id of the user action to update. @param request [OpenStruct, Hash] The request that contains all the new user action information. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1671 
1788 
     | 
    
         | 
| 
       1672 
1789 
     | 
    
         
             
             ### update_user_action_reason(user_action_reason_id, request) [](#method-i-update_user_action_reason)
         
     | 
| 
       1673 
1790 
     | 
    
         
             
             Updates the user action reason with the given Id.
         
     | 
| 
       1674 
1791 
     | 
    
         | 
| 
       1675 
     | 
    
         
            -
            @param user\_action\_reason\_id [string] The Id of the user action reason to update. @param request [OpenStruct, Hash] The request that contains all  
     | 
| 
      
 1792 
     | 
    
         
            +
            @param user\_action\_reason\_id [string] The Id of the user action reason to update. @param request [OpenStruct, Hash] The request that contains all the new user action reason information. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1676 
1793 
     | 
    
         | 
| 
       1677 
1794 
     | 
    
         
             
             ### update_user_consent(user_consent_id, request) [](#method-i-update_user_consent)
         
     | 
| 
       1678 
1795 
     | 
    
         
             
             Updates a single User consent by Id.
         
     | 
| 
         @@ -1682,7 +1799,7 @@ This API is intended to allow you to begin a Two-Factor login outside of a norma 
     | 
|
| 
       1682 
1799 
     | 
    
         
             
             ### update_webhook(webhook_id, request) [](#method-i-update_webhook)
         
     | 
| 
       1683 
1800 
     | 
    
         
             
             Updates the webhook with the given Id.
         
     | 
| 
       1684 
1801 
     | 
    
         | 
| 
       1685 
     | 
    
         
            -
            @param webhook\_id [string] The Id of the webhook to update. @param request [OpenStruct, Hash] The request that contains all  
     | 
| 
      
 1802 
     | 
    
         
            +
            @param webhook\_id [string] The Id of the webhook to update. @param request [OpenStruct, Hash] The request that contains all the new webhook information. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1686 
1803 
     | 
    
         | 
| 
       1687 
1804 
     | 
    
         
             
             ### upsert_entity_grant(entity_id, request) [](#method-i-upsert_entity_grant)
         
     | 
| 
       1688 
1805 
     | 
    
         
             
             Creates or updates an Entity Grant. This is when a User/Entity is granted permissions to an Entity.
         
     | 
| 
         @@ -1706,12 +1823,12 @@ Issue a new access token (JWT) with the provided claims in the request. This JWT 
     | 
|
| 
       1706 
1823 
     | 
    
         | 
| 
       1707 
1824 
     | 
    
         
             
            If a TTL is not provided in the request, the TTL will be retrieved from the default Tenant or the Tenant specified on the request either by way of the X-FusionAuth-TenantId request header, or a tenant scoped API key.
         
     | 
| 
       1708 
1825 
     | 
    
         | 
| 
       1709 
     | 
    
         
            -
            @param request [OpenStruct, Hash] The request that contains all  
     | 
| 
      
 1826 
     | 
    
         
            +
            @param request [OpenStruct, Hash] The request that contains all the claims for this JWT. @return [FusionAuth::ClientResponse] The ClientResponse object.
         
     | 
| 
       1710 
1827 
     | 
    
         | 
| 
       1711 
1828 
     | 
    
         
             
             ### verify_email(verification_id) [](#method-i-verify_email)
         
     | 
| 
       1712 
1829 
     | 
    
         
             
             Confirms a email verification. The Id given is usually from an email sent to the user.
         
     | 
| 
       1713 
1830 
     | 
    
         | 
| 
       1714 
     | 
    
         
            -
            @param verification\_id [string] The email verification  
     | 
| 
      
 1831 
     | 
    
         
            +
            @param verification\_id [string] The email verification Id sent to the user. @return [FusionAuth::ClientResponse] The ClientResponse object. @deprecated This method has been renamed to [`verify_email_address`](FusionAuthClient.html#method-i-verify_email_address) and changed to take a JSON request body, use that method instead.
         
     | 
| 
       1715 
1832 
     | 
    
         | 
| 
       1716 
1833 
     | 
    
         
             
             ### verify_email_address(request) [](#method-i-verify_email_address)
         
     | 
| 
       1717 
1834 
     | 
    
         
             
             Confirms a user’s email address.
         
     |