fusionauth_client 1.49.1 → 1.50.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (67) hide show
  1. checksums.yaml +4 -4
  2. data/.github/dependabot.yml +6 -0
  3. data/.github/fusionauth/.env +6 -0
  4. data/.github/fusionauth/docker-compose.yml +51 -0
  5. data/.github/fusionauth/kickstart.json +46 -0
  6. data/.github/workflows/docs.yml +31 -0
  7. data/.github/workflows/test.yml +31 -0
  8. data/.ruby-version +1 -1
  9. data/Gemfile +5 -6
  10. data/Gemfile.lock +20 -23
  11. data/README.md +225 -0
  12. data/build.savant +2 -2
  13. data/doc/FusionAuth/FusionAuthClient.html +14185 -0
  14. data/doc/FusionAuth/FusionAuthClient.md +197 -80
  15. data/doc/FusionAuth.html +108 -0
  16. data/doc/FusionAuth.md +1 -1
  17. data/doc/created.rid +2 -2
  18. data/doc/css/fonts.css +167 -0
  19. data/doc/css/rdoc.css +619 -0
  20. data/doc/fonts/Lato-Light.ttf +0 -0
  21. data/doc/fonts/Lato-LightItalic.ttf +0 -0
  22. data/doc/fonts/Lato-Regular.ttf +0 -0
  23. data/doc/fonts/Lato-RegularItalic.ttf +0 -0
  24. data/doc/fonts/SourceCodePro-Bold.ttf +0 -0
  25. data/doc/fonts/SourceCodePro-Regular.ttf +0 -0
  26. data/doc/images/add.png +0 -0
  27. data/doc/images/arrow_up.png +0 -0
  28. data/doc/images/brick.png +0 -0
  29. data/doc/images/brick_link.png +0 -0
  30. data/doc/images/bug.png +0 -0
  31. data/doc/images/bullet_black.png +0 -0
  32. data/doc/images/bullet_toggle_minus.png +0 -0
  33. data/doc/images/bullet_toggle_plus.png +0 -0
  34. data/doc/images/date.png +0 -0
  35. data/doc/images/delete.png +0 -0
  36. data/doc/images/find.png +0 -0
  37. data/doc/images/loadingAnimation.gif +0 -0
  38. data/doc/images/macFFBgHack.png +0 -0
  39. data/doc/images/package.png +0 -0
  40. data/doc/images/page_green.png +0 -0
  41. data/doc/images/page_white_text.png +0 -0
  42. data/doc/images/page_white_width.png +0 -0
  43. data/doc/images/plugin.png +0 -0
  44. data/doc/images/ruby.png +0 -0
  45. data/doc/images/tag_blue.png +0 -0
  46. data/doc/images/tag_green.png +0 -0
  47. data/doc/images/transparent.png +0 -0
  48. data/doc/images/wrench.png +0 -0
  49. data/doc/images/wrench_orange.png +0 -0
  50. data/doc/images/zoom.png +0 -0
  51. data/doc/index.html +89 -0
  52. data/doc/js/darkfish.js +84 -0
  53. data/doc/js/navigation.js +105 -0
  54. data/doc/js/navigation.js.gz +0 -0
  55. data/doc/js/search.js +110 -0
  56. data/doc/js/search_index.js +1 -0
  57. data/doc/js/search_index.js.gz +0 -0
  58. data/doc/js/searcher.js +229 -0
  59. data/doc/js/searcher.js.gz +0 -0
  60. data/doc/table_of_contents.html +1765 -0
  61. data/fusionauth-ruby-client.iml +1 -4
  62. data/fusionauth_client.gemspec +2 -2
  63. data/lib/fusionauth/fusionauth_client.rb +84 -1
  64. data/lib/fusionauth/rest_client.rb +1 -1
  65. metadata +54 -4
  66. data/README.adoc +0 -106
  67. 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 of the information about the action being taken including
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 id of the action, any options and the duration (if applicable).
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 id and optionally a license text (for air-gapped deployments)
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 id must be specified.
34
+ Adds a user to an existing family. The family Id must be specified.
35
35
 
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.
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 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.
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 of the information used to change the password. @return [FusionAuth::ClientResponse] The ClientResponse object.
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 (login id 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.
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 of the information used to change the password. @return [FusionAuth::ClientResponse] The ClientResponse object.
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. @param client\_secret [string] The client secret used to authenticate this request. @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.
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 of the information needed to create the APIKey. @return [FusionAuth::ClientResponse] The ClientResponse object.
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 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.
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 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.
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 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.
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 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.
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 of the information used to remove members to the group. @return [FusionAuth::ClientResponse] The ClientResponse object.
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. @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.
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. @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.
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. @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.
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. @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.
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 of the information about all of the refresh tokens to import. @return [FusionAuth::ClientResponse] The ClientResponse object.
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 of the information about all of the users to import. @return [FusionAuth::ClientResponse] The ClientResponse object.
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 by [`FusionAuth`](../FusionAuth.html).
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 authentication. @return [FusionAuth::ClientResponse] The ClientResponse object.
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 of the refresh tokens issued to the owner of the
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 of the information about the modification. @return [FusionAuth::ClientResponse] The ClientResponse object.
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 of the information used to complete login. @return [FusionAuth::ClientResponse] The ClientResponse object.
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 of the information needed to create the APIKey. @return [FusionAuth::ClientResponse] The ClientResponse object.
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 id for the application.
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 id and the application defined in the request.
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 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.
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 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.
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 id or all of the applications if the id is null.
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 of the email templates.
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 id or all of the identity providers if the id is null.
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 of the message templates.
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 id and the given application id.
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 of the total counts for each application and the global registration count.
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 of the user actions.
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 of the user action reasons.
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 id whose tokens to delete. @param application\_id [string] (Optional) The application id of the tokens to delete. @return [FusionAuth::ClientResponse] The ClientResponse object.
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 id is invalid, it is ignored.
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 id is invalid, it is ignored.
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 id is invalid, it is ignored.
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 id for the template. @param request [OpenStruct, Hash] The send email request that contains all of the information used to send the email. @return [FusionAuth::ClientResponse] The ClientResponse object.
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 of the information used to send an email containing a code. @return [FusionAuth::ClientResponse] The ClientResponse object.
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 of the information used to send the Two Factor code to the user. @return [FusionAuth::ClientResponse] The ClientResponse object.
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 of the information used to begin the passwordless login request. @return [FusionAuth::ClientResponse] The ClientResponse object.
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 of a normal login that originated from the Login API (/api/login).
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 of the information used to begin the Two-Factor login request. @return [FusionAuth::ClientResponse] The ClientResponse object.
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 of the new application information. @return [FusionAuth::ClientResponse] The ClientResponse object.
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 id for the application.
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 of the new role information. @return [FusionAuth::ClientResponse] The ClientResponse object.
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 of the new connector information. @return [FusionAuth::ClientResponse] The ClientResponse object.
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 of the new consent information. @return [FusionAuth::ClientResponse] The ClientResponse object.
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 of the new email template information. @return [FusionAuth::ClientResponse] The ClientResponse object.
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 of the new Entity information. @return [FusionAuth::ClientResponse] The ClientResponse object.
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 of the new Entity Type information. @return [FusionAuth::ClientResponse] The ClientResponse object.
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 id for the entity type.
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 of the new permission information. @return [FusionAuth::ClientResponse] The ClientResponse object.
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 of the new form information. @return [FusionAuth::ClientResponse] The ClientResponse object.
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 of the new form field information. @return [FusionAuth::ClientResponse] The ClientResponse object.
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 of the new group information. @return [FusionAuth::ClientResponse] The ClientResponse object.
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 of the new integration information. @return [FusionAuth::ClientResponse] The ClientResponse object.
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 of the new IP Access Control List information. @return [FusionAuth::ClientResponse] The ClientResponse object.
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 of the new key information. @return [FusionAuth::ClientResponse] The ClientResponse object.
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 of the new lambda information. @return [FusionAuth::ClientResponse] The ClientResponse object.
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 of the new message template information. @return [FusionAuth::ClientResponse] The ClientResponse object.
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 of the new messenger information. @return [FusionAuth::ClientResponse] The ClientResponse object.
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 id and the application defined in the request.
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 of the new registration information. @return [FusionAuth::ClientResponse] The ClientResponse object.
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 of the new system configuration information. @return [FusionAuth::ClientResponse] The ClientResponse object.
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 of the new tenant information. @return [FusionAuth::ClientResponse] The ClientResponse object.
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 of the new theme information. @return [FusionAuth::ClientResponse] The ClientResponse object.
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 of the new user information. @return [FusionAuth::ClientResponse] The ClientResponse object.
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 of the new user action information. @return [FusionAuth::ClientResponse] The ClientResponse object.
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 of the new user action reason information. @return [FusionAuth::ClientResponse] The ClientResponse object.
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 of the new webhook information. @return [FusionAuth::ClientResponse] The ClientResponse object.
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 of the claims for this JWT. @return [FusionAuth::ClientResponse] The ClientResponse object.
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 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.
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.