fusionauth_client 1.49.1 → 1.51.0
Sign up to get free protection for your applications and to get access to all the features.
- 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/deploy.yaml +87 -0
- data/.github/workflows/docs.yml +31 -0
- data/.github/workflows/test.yml +33 -0
- data/.ruby-version +1 -1
- data/Gemfile +5 -6
- data/Gemfile.lock +20 -23
- data/README.md +225 -0
- data/build.savant +3 -3
- 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 +56 -5
- 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.
|