fusionauth_client 1.42.0 → 1.43.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/.gitignore +1 -2
- data/Gemfile +2 -0
- data/Gemfile.lock +30 -2
- data/README.adoc +106 -0
- data/build.savant +1 -1
- data/doc/FusionAuth/FusionAuthClient.md +1742 -0
- data/doc/FusionAuth.md +12 -0
- data/doc/created.rid +2 -0
- data/doc/index.db +0 -0
- data/fusionauth_client.gemspec +1 -1
- data/lib/fusionauth/fusionauth_client.rb +1 -1
- data/lib/fusionauth/rest_client.rb +16 -1
- metadata +7 -3
- data/README.md +0 -42
@@ -0,0 +1,1742 @@
|
|
1
|
+
# class FusionAuth::FusionAuthClient [](#class-FusionAuth::FusionAuthClient) [](#top)
|
2
|
+
This class is the the Ruby client library for the [`FusionAuth`](../FusionAuth.html) CIAM Platform {[fusionauth.io](https://fusionauth.io)}
|
3
|
+
|
4
|
+
Each method on this class calls one of the APIs for [`FusionAuth`](../FusionAuth.html). In most cases, the methods will take either a Hash, an OpenStruct or any object that can be safely converted to JSON that conforms to the [`FusionAuth`](../FusionAuth.html) API interface. Likewise, most methods will return an OpenStruct that contains the response JSON from [`FusionAuth`](../FusionAuth.html).
|
5
|
+
|
6
|
+
noinspection RubyInstanceMethodNamingConvention,RubyTooManyMethodsInspection,RubyParameterNamingConvention
|
7
|
+
|
8
|
+
## Attributes
|
9
|
+
### api_key[RW] [](#attribute-i-api_key)
|
10
|
+
### base_url[RW] [](#attribute-i-base_url)
|
11
|
+
### connect_timeout[RW] [](#attribute-i-connect_timeout)
|
12
|
+
### read_timeout[RW] [](#attribute-i-read_timeout)
|
13
|
+
### tenant_id[RW] [](#attribute-i-tenant_id)
|
14
|
+
## Public Class Methods
|
15
|
+
### new(api_key, base_url) [](#method-c-new)
|
16
|
+
## Public Instance Methods
|
17
|
+
### action_user(request) [](#method-i-action_user)
|
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
|
+
|
20
|
+
@param request [OpenStruct, Hash] The action request that includes all of the information about the action being taken including
|
21
|
+
|
22
|
+
```
|
23
|
+
the id of the action, any options and the duration (if applicable).
|
24
|
+
```
|
25
|
+
|
26
|
+
@return [FusionAuth::ClientResponse] The ClientResponse object.
|
27
|
+
|
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)
|
30
|
+
|
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
|
+
|
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.
|
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.
|
37
|
+
|
38
|
+
### cancel_action(action_id, request) [](#method-i-cancel_action)
|
39
|
+
Cancels the user action.
|
40
|
+
|
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.
|
42
|
+
|
43
|
+
### change_password(change_password_id, request) [](#method-i-change_password)
|
44
|
+
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
|
+
|
46
|
+
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
|
+
|
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.
|
49
|
+
|
50
|
+
### 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.
|
52
|
+
|
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.
|
54
|
+
|
55
|
+
### check_change_password_using_id(change_password_id) [](#method-i-check_change_password_using_id)
|
56
|
+
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.
|
57
|
+
|
58
|
+
An HTTP status code of 400 with a general error code of [TrustTokenRequired] indicates that a Trust Token is required to make a POST request to this API.
|
59
|
+
|
60
|
+
@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. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
61
|
+
|
62
|
+
### check_change_password_using_jwt(encoded_jwt) [](#method-i-check_change_password_using_jwt)
|
63
|
+
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.
|
64
|
+
|
65
|
+
An HTTP status code of 400 with a general error code of [TrustTokenRequired] indicates that a Trust Token is required to make a POST request to this API.
|
66
|
+
|
67
|
+
@param encoded\_jwt [string] The encoded JWT (access token). @return [FusionAuth::ClientResponse] The ClientResponse object.
|
68
|
+
|
69
|
+
### check_change_password_using_login_id(login_id) [](#method-i-check_change_password_using_login_id)
|
70
|
+
Check to see if the user must obtain a Trust Request 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 Request Id by completing a Two-Factor Step-Up authentication.
|
71
|
+
|
72
|
+
An HTTP status code of 400 with a general error code of [TrustTokenRequired] indicates that a Trust Token is required to make a POST request to this API.
|
73
|
+
|
74
|
+
@param login\_id [string] The loginId of the User that you intend to change the password for. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
75
|
+
|
76
|
+
### client_credentials_grant(client_id, client_secret, scope) [](#method-i-client_credentials_grant)
|
77
|
+
Make a Client Credentials grant request to obtain an access token.
|
78
|
+
|
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.
|
80
|
+
|
81
|
+
### comment_on_user(request) [](#method-i-comment_on_user)
|
82
|
+
Adds a comment to the user’s account.
|
83
|
+
|
84
|
+
@param request [OpenStruct, Hash] The request object that contains all the information used to create the user comment. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
85
|
+
|
86
|
+
### complete_web_authn_assertion(request) [](#method-i-complete_web_authn_assertion)
|
87
|
+
Complete a WebAuthn authentication ceremony by validating the signature against the previously generated challenge without logging the user in
|
88
|
+
|
89
|
+
@param request [OpenStruct, Hash] An object containing data necessary for completing the authentication ceremony @return [FusionAuth::ClientResponse] The ClientResponse object.
|
90
|
+
|
91
|
+
### complete_web_authn_login(request) [](#method-i-complete_web_authn_login)
|
92
|
+
Complete a WebAuthn authentication ceremony by validating the signature against the previously generated challenge and then login the user in
|
93
|
+
|
94
|
+
@param request [OpenStruct, Hash] An object containing data necessary for completing the authentication ceremony @return [FusionAuth::ClientResponse] The ClientResponse object.
|
95
|
+
|
96
|
+
### complete_web_authn_registration(request) [](#method-i-complete_web_authn_registration)
|
97
|
+
Complete a WebAuthn registration ceremony by validating the client request and saving the new credential
|
98
|
+
|
99
|
+
@param request [OpenStruct, Hash] An object containing data necessary for completing the registration ceremony @return [FusionAuth::ClientResponse] The ClientResponse object.
|
100
|
+
|
101
|
+
### create_api_key(key_id, request) [](#method-i-create_api_key)
|
102
|
+
Creates an API key. You can optionally specify a unique Id for the key, if not provided one will be generated. an API key can only be created with equal or lesser authority. An API key cannot create another API key unless it is granted to that API key.
|
103
|
+
|
104
|
+
If an API key is locked to a tenant, it can only create API Keys for that same tenant.
|
105
|
+
|
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.
|
107
|
+
|
108
|
+
### create_application(application_id, request) [](#method-i-create_application)
|
109
|
+
Creates an application. You can optionally specify an Id for the application, if not provided one will be generated.
|
110
|
+
|
111
|
+
@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
|
+
|
113
|
+
### 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.
|
115
|
+
|
116
|
+
@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
|
+
|
118
|
+
### create_audit_log(request) [](#method-i-create_audit_log)
|
119
|
+
Creates an audit log with the message and user name (usually an email). Audit logs should be written anytime you make changes to the [`FusionAuth`](../FusionAuth.html) database. When using the [`FusionAuth`](../FusionAuth.html) App web interface, any changes are automatically written to the audit log. However, if you are accessing the API, you must write the audit logs yourself.
|
120
|
+
|
121
|
+
@param request [OpenStruct, Hash] The request object that contains all the information used to create the audit log entry. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
122
|
+
|
123
|
+
### create_connector(connector_id, request) [](#method-i-create_connector)
|
124
|
+
Creates a connector. You can optionally specify an Id for the connector, if not provided one will be generated.
|
125
|
+
|
126
|
+
@param connector\_id [string] (Optional) The Id for the connector. 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 connector. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
127
|
+
|
128
|
+
### create_consent(consent_id, request) [](#method-i-create_consent)
|
129
|
+
Creates a user consent type. You can optionally specify an Id for the consent type, if not provided one will be generated.
|
130
|
+
|
131
|
+
@param consent\_id [string] (Optional) The Id for the consent. 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 consent. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
132
|
+
|
133
|
+
### create_email_template(email_template_id, request) [](#method-i-create_email_template)
|
134
|
+
Creates an email template. You can optionally specify an Id for the template, if not provided one will be generated.
|
135
|
+
|
136
|
+
@param email\_template\_id [string] (Optional) The Id for the template. 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 email template. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
137
|
+
|
138
|
+
### create_entity(entity_id, request) [](#method-i-create_entity)
|
139
|
+
Creates an Entity. You can optionally specify an Id for the Entity. If not provided one will be generated.
|
140
|
+
|
141
|
+
@param entity\_id [string] (Optional) The Id for the Entity. 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. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
142
|
+
|
143
|
+
### create_entity_type(entity_type_id, request) [](#method-i-create_entity_type)
|
144
|
+
Creates a Entity Type. You can optionally specify an Id for the Entity Type, if not provided one will be generated.
|
145
|
+
|
146
|
+
@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
|
+
|
148
|
+
### 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.
|
150
|
+
|
151
|
+
@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
|
+
|
153
|
+
### 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.
|
155
|
+
|
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.
|
157
|
+
|
158
|
+
### create_form(form_id, request) [](#method-i-create_form)
|
159
|
+
Creates a form. You can optionally specify an Id for the form, if not provided one will be generated.
|
160
|
+
|
161
|
+
@param form\_id [string] (Optional) The Id for the form. 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 form. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
162
|
+
|
163
|
+
### create_form_field(field_id, request) [](#method-i-create_form_field)
|
164
|
+
Creates a form field. You can optionally specify an Id for the form, if not provided one will be generated.
|
165
|
+
|
166
|
+
@param field\_id [string] (Optional) The Id for the form field. 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 form field. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
167
|
+
|
168
|
+
### create_group(group_id, request) [](#method-i-create_group)
|
169
|
+
Creates a group. You can optionally specify an Id for the group, if not provided one will be generated.
|
170
|
+
|
171
|
+
@param group\_id [string] (Optional) The Id for the group. 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 group. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
172
|
+
|
173
|
+
### create_group_members(request) [](#method-i-create_group_members)
|
174
|
+
Creates a member in a group.
|
175
|
+
|
176
|
+
@param request [OpenStruct, Hash] The request object that contains all the information used to create the group member(s). @return [FusionAuth::ClientResponse] The ClientResponse object.
|
177
|
+
|
178
|
+
### create_identity_provider(identity_provider_id, request) [](#method-i-create_identity_provider)
|
179
|
+
Creates an identity provider. You can optionally specify an Id for the identity provider, if not provided one will be generated.
|
180
|
+
|
181
|
+
@param identity\_provider\_id [string] (Optional) The Id of the identity provider. 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 identity provider. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
182
|
+
|
183
|
+
### create_ip_access_control_list(access_control_list_id, request) [](#method-i-create_ip_access_control_list)
|
184
|
+
Creates an IP Access Control List. You can optionally specify an Id on this create request, if one is not provided one will be generated.
|
185
|
+
|
186
|
+
@param access\_control\_list\_id [string] (Optional) The Id for the IP Access Control List. 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 IP Access Control List. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
187
|
+
|
188
|
+
### create_lambda(lambda_id, request) [](#method-i-create_lambda)
|
189
|
+
Creates a Lambda. You can optionally specify an Id for the lambda, if not provided one will be generated.
|
190
|
+
|
191
|
+
@param lambda\_id [string] (Optional) The Id for the lambda. 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 lambda. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
192
|
+
|
193
|
+
### create_message_template(message_template_id, request) [](#method-i-create_message_template)
|
194
|
+
Creates an message template. You can optionally specify an Id for the template, if not provided one will be generated.
|
195
|
+
|
196
|
+
@param message\_template\_id [string] (Optional) The Id for the template. 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 message template. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
197
|
+
|
198
|
+
### create_messenger(messenger_id, request) [](#method-i-create_messenger)
|
199
|
+
Creates a messenger. You can optionally specify an Id for the messenger, if not provided one will be generated.
|
200
|
+
|
201
|
+
@param messenger\_id [string] (Optional) The Id for the messenger. 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 messenger. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
202
|
+
|
203
|
+
### create_tenant(tenant_id, request) [](#method-i-create_tenant)
|
204
|
+
Creates a tenant. You can optionally specify an Id for the tenant, if not provided one will be generated.
|
205
|
+
|
206
|
+
@param [`tenant_id`](FusionAuthClient.html#attribute-i-tenant_id) [string] (Optional) The Id for the tenant. 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 tenant. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
207
|
+
|
208
|
+
### create_theme(theme_id, request) [](#method-i-create_theme)
|
209
|
+
Creates a Theme. You can optionally specify an Id for the theme, if not provided one will be generated.
|
210
|
+
|
211
|
+
@param theme\_id [string] (Optional) The Id for the theme. 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 theme. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
212
|
+
|
213
|
+
### create_user(user_id, request) [](#method-i-create_user)
|
214
|
+
Creates a user. You can optionally specify an Id for the user, if not provided one will be generated.
|
215
|
+
|
216
|
+
@param user\_id [string] (Optional) The Id for the user. 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 user. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
217
|
+
|
218
|
+
### create_user_action(user_action_id, request) [](#method-i-create_user_action)
|
219
|
+
Creates a user action. This action cannot be taken on a user until this call successfully returns. Anytime after that the user action can be applied to any user.
|
220
|
+
|
221
|
+
@param user\_action\_id [string] (Optional) The Id for the user action. 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 user action. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
222
|
+
|
223
|
+
### create_user_action_reason(user_action_reason_id, request) [](#method-i-create_user_action_reason)
|
224
|
+
Creates a user reason. This user action reason cannot be used when actioning a user until this call completes successfully. Anytime after that the user action reason can be used.
|
225
|
+
|
226
|
+
@param user\_action\_reason\_id [string] (Optional) The Id for the user action reason. 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 user action reason. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
227
|
+
|
228
|
+
### create_user_consent(user_consent_id, request) [](#method-i-create_user_consent)
|
229
|
+
Creates a single User consent.
|
230
|
+
|
231
|
+
@param user\_consent\_id [string] (Optional) The Id for the User consent. If not provided a secure random UUID will be generated. @param request [OpenStruct, Hash] The request that contains the user consent information. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
232
|
+
|
233
|
+
### create_user_link(request) [](#method-i-create_user_link)
|
234
|
+
Link an external user from a 3rd party identity provider to a [`FusionAuth`](../FusionAuth.html) user.
|
235
|
+
|
236
|
+
@param request [OpenStruct, Hash] The request object that contains all the information used to link the [`FusionAuth`](../FusionAuth.html) user. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
237
|
+
|
238
|
+
### create_webhook(webhook_id, request) [](#method-i-create_webhook)
|
239
|
+
Creates a webhook. You can optionally specify an Id for the webhook, if not provided one will be generated.
|
240
|
+
|
241
|
+
@param webhook\_id [string] (Optional) The Id for the webhook. 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 webhook. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
242
|
+
|
243
|
+
### deactivate_application(application_id) [](#method-i-deactivate_application)
|
244
|
+
Deactivates the application with the given Id.
|
245
|
+
|
246
|
+
@param application\_id [string] The Id of the application to deactivate. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
247
|
+
|
248
|
+
### deactivate_reactor() [](#method-i-deactivate_reactor)
|
249
|
+
Deactivates the [`FusionAuth`](../FusionAuth.html) Reactor.
|
250
|
+
|
251
|
+
@return [FusionAuth::ClientResponse] The ClientResponse object.
|
252
|
+
|
253
|
+
### deactivate_user(user_id) [](#method-i-deactivate_user)
|
254
|
+
Deactivates the user with the given Id.
|
255
|
+
|
256
|
+
@param user\_id [string] The Id of the user to deactivate. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
257
|
+
|
258
|
+
### deactivate_user_action(user_action_id) [](#method-i-deactivate_user_action)
|
259
|
+
Deactivates the user action with the given Id.
|
260
|
+
|
261
|
+
@param user\_action\_id [string] The Id of the user action to deactivate. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
262
|
+
|
263
|
+
### deactivate_users(user_ids) [](#method-i-deactivate_users)
|
264
|
+
Deactivates the users with the given ids.
|
265
|
+
|
266
|
+
@param user\_ids [Array] The ids of the users to deactivate. @return [FusionAuth::ClientResponse] The ClientResponse object. @deprecated This method has been renamed to [`deactivate_users_by_ids`](FusionAuthClient.html#method-i-deactivate_users_by_ids), use that method instead.
|
267
|
+
|
268
|
+
### deactivate_users_by_ids(user_ids) [](#method-i-deactivate_users_by_ids)
|
269
|
+
Deactivates the users with the given ids.
|
270
|
+
|
271
|
+
@param user\_ids [Array] The ids of the users to deactivate. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
272
|
+
|
273
|
+
### delete_api_key(key_id) [](#method-i-delete_api_key)
|
274
|
+
Deletes the API key for the given Id.
|
275
|
+
|
276
|
+
@param key\_id [string] The Id of the authentication API key to delete. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
277
|
+
|
278
|
+
### delete_application(application_id) [](#method-i-delete_application)
|
279
|
+
Hard deletes an application. This is a dangerous operation and should not be used in most circumstances. This will delete the application, any registrations for that application, metrics and reports for the application, all the roles for the application, and any other data associated with the application. This operation could take a very long time, depending on the amount of data in your database.
|
280
|
+
|
281
|
+
@param application\_id [string] The Id of the application to delete. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
282
|
+
|
283
|
+
### delete_application_role(application_id, role_id) [](#method-i-delete_application_role)
|
284
|
+
Hard deletes an application role. This is a dangerous operation and should not be used in most circumstances. This permanently removes the given role from all users that had it.
|
285
|
+
|
286
|
+
@param application\_id [string] The Id of the application to deactivate. @param role\_id [string] The Id of the role to delete. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
287
|
+
|
288
|
+
### delete_connector(connector_id) [](#method-i-delete_connector)
|
289
|
+
Deletes the connector for the given Id.
|
290
|
+
|
291
|
+
@param connector\_id [string] The Id of the connector to delete. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
292
|
+
|
293
|
+
### delete_consent(consent_id) [](#method-i-delete_consent)
|
294
|
+
Deletes the consent for the given Id.
|
295
|
+
|
296
|
+
@param consent\_id [string] The Id of the consent to delete. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
297
|
+
|
298
|
+
### delete_email_template(email_template_id) [](#method-i-delete_email_template)
|
299
|
+
Deletes the email template for the given Id.
|
300
|
+
|
301
|
+
@param email\_template\_id [string] The Id of the email template to delete. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
302
|
+
|
303
|
+
### delete_entity(entity_id) [](#method-i-delete_entity)
|
304
|
+
Deletes the Entity for the given Id.
|
305
|
+
|
306
|
+
@param entity\_id [string] The Id of the Entity to delete. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
307
|
+
|
308
|
+
### delete_entity_grant(entity_id, recipient_entity_id, user_id) [](#method-i-delete_entity_grant)
|
309
|
+
Deletes an Entity Grant for the given User or Entity.
|
310
|
+
|
311
|
+
@param entity\_id [string] The Id of the Entity that the Entity Grant is being deleted for. @param recipient\_entity\_id [string] (Optional) The Id of the Entity that the Entity Grant is for. @param user\_id [string] (Optional) The Id of the User that the Entity Grant is for. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
312
|
+
|
313
|
+
### delete_entity_type(entity_type_id) [](#method-i-delete_entity_type)
|
314
|
+
Deletes the Entity Type for the given Id.
|
315
|
+
|
316
|
+
@param entity\_type\_id [string] The Id of the Entity Type to delete. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
317
|
+
|
318
|
+
### delete_entity_type_permission(entity_type_id, permission_id) [](#method-i-delete_entity_type_permission)
|
319
|
+
Hard deletes a permission. This is a dangerous operation and should not be used in most circumstances. This permanently removes the given permission from all grants that had it.
|
320
|
+
|
321
|
+
@param entity\_type\_id [string] The Id of the entityType the the permission belongs to. @param permission\_id [string] The Id of the permission to delete. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
322
|
+
|
323
|
+
### delete_form(form_id) [](#method-i-delete_form)
|
324
|
+
Deletes the form for the given Id.
|
325
|
+
|
326
|
+
@param form\_id [string] The Id of the form to delete. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
327
|
+
|
328
|
+
### delete_form_field(field_id) [](#method-i-delete_form_field)
|
329
|
+
Deletes the form field for the given Id.
|
330
|
+
|
331
|
+
@param field\_id [string] The Id of the form field to delete. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
332
|
+
|
333
|
+
### delete_group(group_id) [](#method-i-delete_group)
|
334
|
+
Deletes the group for the given Id.
|
335
|
+
|
336
|
+
@param group\_id [string] The Id of the group to delete. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
337
|
+
|
338
|
+
### delete_group_members(request) [](#method-i-delete_group_members)
|
339
|
+
Removes users as members of a group.
|
340
|
+
|
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.
|
342
|
+
|
343
|
+
### delete_identity_provider(identity_provider_id) [](#method-i-delete_identity_provider)
|
344
|
+
Deletes the identity provider for the given Id.
|
345
|
+
|
346
|
+
@param identity\_provider\_id [string] The Id of the identity provider to delete. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
347
|
+
|
348
|
+
### delete_ip_access_control_list(ip_access_control_list_id) [](#method-i-delete_ip_access_control_list)
|
349
|
+
Deletes the IP Access Control List for the given Id.
|
350
|
+
|
351
|
+
@param ip\_access\_control\_list\_id [string] The Id of the IP Access Control List to delete. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
352
|
+
|
353
|
+
### delete_key(key_id) [](#method-i-delete_key)
|
354
|
+
Deletes the key for the given Id.
|
355
|
+
|
356
|
+
@param key\_id [string] The Id of the key to delete. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
357
|
+
|
358
|
+
### delete_lambda(lambda_id) [](#method-i-delete_lambda)
|
359
|
+
Deletes the lambda for the given Id.
|
360
|
+
|
361
|
+
@param lambda\_id [string] The Id of the lambda to delete. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
362
|
+
|
363
|
+
### delete_message_template(message_template_id) [](#method-i-delete_message_template)
|
364
|
+
Deletes the message template for the given Id.
|
365
|
+
|
366
|
+
@param message\_template\_id [string] The Id of the message template to delete. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
367
|
+
|
368
|
+
### delete_messenger(messenger_id) [](#method-i-delete_messenger)
|
369
|
+
Deletes the messenger for the given Id.
|
370
|
+
|
371
|
+
@param messenger\_id [string] The Id of the messenger to delete. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
372
|
+
|
373
|
+
### delete_registration(user_id, application_id) [](#method-i-delete_registration)
|
374
|
+
Deletes the user registration for the given user and application.
|
375
|
+
|
376
|
+
@param user\_id [string] The Id of the user whose registration is being deleted. @param application\_id [string] The Id of the application to remove the registration for. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
377
|
+
|
378
|
+
### delete_registration_with_request(user_id, application_id, request) [](#method-i-delete_registration_with_request)
|
379
|
+
Deletes the user registration for the given user and application along with the given JSON body that contains the event information.
|
380
|
+
|
381
|
+
@param user\_id [string] The Id of the user whose registration is being deleted. @param application\_id [string] The Id of the application to remove the registration for. @param request [OpenStruct, Hash] The request body that contains the event information. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
382
|
+
|
383
|
+
### delete_tenant(tenant_id) [](#method-i-delete_tenant)
|
384
|
+
Deletes the tenant based on the given Id on the URL. This permanently deletes all information, metrics, reports and data associated with the tenant and everything under the tenant (applications, users, etc).
|
385
|
+
|
386
|
+
@param [`tenant_id`](FusionAuthClient.html#attribute-i-tenant_id) [string] The Id of the tenant to delete. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
387
|
+
|
388
|
+
### delete_tenant_async(tenant_id) [](#method-i-delete_tenant_async)
|
389
|
+
Deletes the tenant for the given Id asynchronously. This method is helpful if you do not want to wait for the delete operation to complete.
|
390
|
+
|
391
|
+
@param [`tenant_id`](FusionAuthClient.html#attribute-i-tenant_id) [string] The Id of the tenant to delete. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
392
|
+
|
393
|
+
### delete_tenant_with_request(tenant_id, request) [](#method-i-delete_tenant_with_request)
|
394
|
+
Deletes the tenant based on the given request (sent to the API as JSON). This permanently deletes all information, metrics, reports and data associated with the tenant and everything under the tenant (applications, users, etc).
|
395
|
+
|
396
|
+
@param [`tenant_id`](FusionAuthClient.html#attribute-i-tenant_id) [string] The Id of the tenant to delete. @param request [OpenStruct, Hash] The request object that contains all the information used to delete the user. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
397
|
+
|
398
|
+
### delete_theme(theme_id) [](#method-i-delete_theme)
|
399
|
+
Deletes the theme for the given Id.
|
400
|
+
|
401
|
+
@param theme\_id [string] The Id of the theme to delete. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
402
|
+
|
403
|
+
### delete_user(user_id) [](#method-i-delete_user)
|
404
|
+
Deletes the user for the given Id. This permanently deletes all information, metrics, reports and data associated with the user.
|
405
|
+
|
406
|
+
@param user\_id [string] The Id of the user to delete. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
407
|
+
|
408
|
+
### delete_user_action(user_action_id) [](#method-i-delete_user_action)
|
409
|
+
Deletes the user action for the given Id. This permanently deletes the user action and also any history and logs of the action being applied to any users.
|
410
|
+
|
411
|
+
@param user\_action\_id [string] The Id of the user action to delete. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
412
|
+
|
413
|
+
### delete_user_action_reason(user_action_reason_id) [](#method-i-delete_user_action_reason)
|
414
|
+
Deletes the user action reason for the given Id.
|
415
|
+
|
416
|
+
@param user\_action\_reason\_id [string] The Id of the user action reason to delete. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
417
|
+
|
418
|
+
### delete_user_link(identity_provider_id, identity_provider_user_id, user_id) [](#method-i-delete_user_link)
|
419
|
+
Remove an existing link that has been made from a 3rd party identity provider to a [`FusionAuth`](../FusionAuth.html) user.
|
420
|
+
|
421
|
+
@param identity\_provider\_id [string] The unique Id of the identity provider. @param identity\_provider\_user\_id [string] The unique Id of the user in the 3rd party identity provider to unlink. @param user\_id [string] The unique Id of the [`FusionAuth`](../FusionAuth.html) user to unlink. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
422
|
+
|
423
|
+
### delete_user_with_request(user_id, request) [](#method-i-delete_user_with_request)
|
424
|
+
Deletes the user based on the given request (sent to the API as JSON). This permanently deletes all information, metrics, reports and data associated with the user.
|
425
|
+
|
426
|
+
@param user\_id [string] The Id of the user to delete (required). @param request [OpenStruct, Hash] The request object that contains all the information used to delete the user. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
427
|
+
|
428
|
+
### delete_users(request) [](#method-i-delete_users)
|
429
|
+
Deletes the users with the given ids, or users matching the provided JSON query or queryString. The order of preference is ids, query and then queryString, it is recommended to only provide one of the three for the request.
|
430
|
+
|
431
|
+
This method can be used to deactivate or permanently delete (hard-delete) users based upon the hardDelete boolean in the request body. Using the dryRun parameter you may also request the result of the action without actually deleting or deactivating any users.
|
432
|
+
|
433
|
+
@param request [OpenStruct, Hash] The UserDeleteRequest. @return [FusionAuth::ClientResponse] The ClientResponse object. @deprecated This method has been renamed to [`delete_users_by_query`](FusionAuthClient.html#method-i-delete_users_by_query), use that method instead.
|
434
|
+
|
435
|
+
### delete_users_by_query(request) [](#method-i-delete_users_by_query)
|
436
|
+
Deletes the users with the given ids, or users matching the provided JSON query or queryString. The order of preference is ids, query and then queryString, it is recommended to only provide one of the three for the request.
|
437
|
+
|
438
|
+
This method can be used to deactivate or permanently delete (hard-delete) users based upon the hardDelete boolean in the request body. Using the dryRun parameter you may also request the result of the action without actually deleting or deactivating any users.
|
439
|
+
|
440
|
+
@param request [OpenStruct, Hash] The UserDeleteRequest. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
441
|
+
|
442
|
+
### delete_web_authn_credential(id) [](#method-i-delete_web_authn_credential)
|
443
|
+
Deletes the WebAuthn credential for the given Id.
|
444
|
+
|
445
|
+
@param id [string] The Id of the WebAuthn credential to delete. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
446
|
+
|
447
|
+
### delete_webhook(webhook_id) [](#method-i-delete_webhook)
|
448
|
+
Deletes the webhook for the given Id.
|
449
|
+
|
450
|
+
@param webhook\_id [string] The Id of the webhook to delete. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
451
|
+
|
452
|
+
### disable_two_factor(user_id, method_id, code) [](#method-i-disable_two_factor)
|
453
|
+
Disable two-factor authentication for a user.
|
454
|
+
|
455
|
+
@param user\_id [string] The Id of the User for which you’re disabling two-factor authentication. @param method\_id [string] The two-factor method identifier you wish to disable @param code [string] The two-factor code used verify the the caller knows the two-factor secret. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
456
|
+
|
457
|
+
### disable_two_factor_with_request(user_id, request) [](#method-i-disable_two_factor_with_request)
|
458
|
+
Disable two-factor authentication for a user using a JSON body rather than URL parameters.
|
459
|
+
|
460
|
+
@param user\_id [string] The Id of the User for which you’re disabling two-factor authentication. @param request [OpenStruct, Hash] The request information that contains the code and methodId along with any event information. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
461
|
+
|
462
|
+
### enable_two_factor(user_id, request) [](#method-i-enable_two_factor)
|
463
|
+
Enable two-factor authentication for a user.
|
464
|
+
|
465
|
+
@param user\_id [string] The Id of the user to enable two-factor authentication. @param request [OpenStruct, Hash] The two-factor enable request information. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
466
|
+
|
467
|
+
### exchange_o_auth_code_for_access_token(code, client_id, client_secret, redirect_uri) [](#method-i-exchange_o_auth_code_for_access_token)
|
468
|
+
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
|
+
|
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.
|
471
|
+
|
472
|
+
### 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
|
+
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
|
+
|
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.
|
476
|
+
|
477
|
+
### exchange_refresh_token_for_access_token(refresh_token, client_id, client_secret, scope, user_code) [](#method-i-exchange_refresh_token_for_access_token)
|
478
|
+
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
|
+
|
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.
|
481
|
+
|
482
|
+
### exchange_refresh_token_for_jwt(request) [](#method-i-exchange_refresh_token_for_jwt)
|
483
|
+
Exchange a refresh token for a new JWT.
|
484
|
+
|
485
|
+
@param request [OpenStruct, Hash] The refresh request. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
486
|
+
|
487
|
+
### exchange_user_credentials_for_access_token(username, password, client_id, client_secret, scope, user_code) [](#method-i-exchange_user_credentials_for_access_token)
|
488
|
+
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
|
+
|
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.
|
491
|
+
|
492
|
+
### forgot_password(request) [](#method-i-forgot_password)
|
493
|
+
Begins the forgot password sequence, which kicks off an email to the user so that they can reset their password.
|
494
|
+
|
495
|
+
@param request [OpenStruct, Hash] The request that contains the information about the user so that they can be emailed. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
496
|
+
|
497
|
+
### generate_email_verification_id(email) [](#method-i-generate_email_verification_id)
|
498
|
+
Generate a new Email Verification Id to be used with the Verify Email API. This API will not attempt to send an email to the User. This API may be used to collect the verificationId for use with a third party system.
|
499
|
+
|
500
|
+
@param email [string] The email address of the user that needs a new verification email. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
501
|
+
|
502
|
+
### generate_key(key_id, request) [](#method-i-generate_key)
|
503
|
+
Generate a new RSA or EC key pair or an HMAC secret.
|
504
|
+
|
505
|
+
@param key\_id [string] (Optional) The Id for the key. 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 key. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
506
|
+
|
507
|
+
### generate_registration_verification_id(email, application_id) [](#method-i-generate_registration_verification_id)
|
508
|
+
Generate a new Application Registration Verification Id to be used with the Verify Registration API. This API will not attempt to send an email to the User. This API may be used to collect the verificationId for use with a third party system.
|
509
|
+
|
510
|
+
@param email [string] The email address of the user that needs a new verification email. @param application\_id [string] The Id of the application to be verified. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
511
|
+
|
512
|
+
### generate_two_factor_recovery_codes(user_id) [](#method-i-generate_two_factor_recovery_codes)
|
513
|
+
Generate two-factor recovery codes for a user. Generating two-factor recovery codes will invalidate any existing recovery codes.
|
514
|
+
|
515
|
+
@param user\_id [string] The Id of the user to generate new Two Factor recovery codes. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
516
|
+
|
517
|
+
### generate_two_factor_secret() [](#method-i-generate_two_factor_secret)
|
518
|
+
Generate a Two Factor secret that can be used to enable Two Factor authentication for a User. The response will contain both the secret and a Base32 encoded form of the secret which can be shown to a User when using a 2 Step Authentication application such as Google Authenticator.
|
519
|
+
|
520
|
+
@return [FusionAuth::ClientResponse] The ClientResponse object.
|
521
|
+
|
522
|
+
### generate_two_factor_secret_using_jwt(encoded_jwt) [](#method-i-generate_two_factor_secret_using_jwt)
|
523
|
+
Generate a Two Factor secret that can be used to enable Two Factor authentication for a User. The response will contain both the secret and a Base32 encoded form of the secret which can be shown to a User when using a 2 Step Authentication application such as Google Authenticator.
|
524
|
+
|
525
|
+
@param encoded\_jwt [string] The encoded JWT (access token). @return [FusionAuth::ClientResponse] The ClientResponse object.
|
526
|
+
|
527
|
+
### identity_provider_login(request) [](#method-i-identity_provider_login)
|
528
|
+
Handles login via third-parties including Social login, external OAuth and OpenID Connect, and other login systems.
|
529
|
+
|
530
|
+
@param request [OpenStruct, Hash] The third-party login request that contains information from the third-party login
|
531
|
+
|
532
|
+
```
|
533
|
+
providers that FusionAuth uses to reconcile the user's account.
|
534
|
+
```
|
535
|
+
|
536
|
+
@return [FusionAuth::ClientResponse] The ClientResponse object.
|
537
|
+
|
538
|
+
### import_key(key_id, request) [](#method-i-import_key)
|
539
|
+
Import an existing RSA or EC key pair or an HMAC secret.
|
540
|
+
|
541
|
+
@param key\_id [string] (Optional) The Id for the key. 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 key. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
542
|
+
|
543
|
+
### import_refresh_tokens(request) [](#method-i-import_refresh_tokens)
|
544
|
+
Bulk imports refresh tokens. This request performs minimal validation and runs batch inserts of refresh tokens with the expectation that each token represents a user that already exists and is registered for the corresponding [`FusionAuth`](../FusionAuth.html) Application. This is done to increases the insert performance.
|
545
|
+
|
546
|
+
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
|
+
|
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.
|
549
|
+
|
550
|
+
### import_users(request) [](#method-i-import_users)
|
551
|
+
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
|
+
|
553
|
+
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
|
+
|
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.
|
556
|
+
|
557
|
+
### import_web_authn_credential(request) [](#method-i-import_web_authn_credential)
|
558
|
+
Import a WebAuthn credential
|
559
|
+
|
560
|
+
@param request [OpenStruct, Hash] An object containing data necessary for importing the credential @return [FusionAuth::ClientResponse] The ClientResponse object.
|
561
|
+
|
562
|
+
### introspect_access_token(client_id, token) [](#method-i-introspect_access_token)
|
563
|
+
Inspect an access token issued by [`FusionAuth`](../FusionAuth.html).
|
564
|
+
|
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.
|
566
|
+
|
567
|
+
### issue_jwt(application_id, encoded_jwt, refresh_token) [](#method-i-issue_jwt)
|
568
|
+
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.
|
569
|
+
|
570
|
+
@param application\_id [string] The Application Id for which you are requesting a new access token be issued. @param encoded\_jwt [string] The encoded JWT (access token). @param refresh\_token [string] (Optional) An existing refresh token used to request a refresh token in addition to a JWT in the response.
|
571
|
+
|
572
|
+
```
|
573
|
+
<p>The target application represented by the applicationId request parameter must have refresh
|
574
|
+
tokens enabled in order to receive a refresh token in the response.</p>
|
575
|
+
```
|
576
|
+
|
577
|
+
@return [FusionAuth::ClientResponse] The ClientResponse object.
|
578
|
+
|
579
|
+
### login(request) [](#method-i-login)
|
580
|
+
Authenticates a user to [`FusionAuth`](../FusionAuth.html).
|
581
|
+
|
582
|
+
This API optionally requires an API key. See `Application.loginConfiguration.requireAuthentication`.
|
583
|
+
|
584
|
+
@param request [OpenStruct, Hash] The login request that contains the user credentials used to log them in. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
585
|
+
|
586
|
+
### login_ping(user_id, application_id, caller_ip_address) [](#method-i-login_ping)
|
587
|
+
Sends a ping to [`FusionAuth`](../FusionAuth.html) indicating that the user was automatically logged into an application. When using FusionAuth’s SSO or your own, you should call this if the user is already logged in centrally, but accesses an application where they no longer have a session. This helps correctly track login counts, times and helps with reporting.
|
588
|
+
|
589
|
+
@param user\_id [string] The Id of the user that was logged in. @param application\_id [string] The Id of the application that they logged into. @param caller\_ip\_address [string] (Optional) The IP address of the end-user that is logging in. If a null value is provided
|
590
|
+
|
591
|
+
```
|
592
|
+
the IP address will be that of the client or last proxy that sent the request.
|
593
|
+
```
|
594
|
+
|
595
|
+
@return [FusionAuth::ClientResponse] The ClientResponse object.
|
596
|
+
|
597
|
+
### login_ping_with_request(request) [](#method-i-login_ping_with_request)
|
598
|
+
Sends a ping to [`FusionAuth`](../FusionAuth.html) indicating that the user was automatically logged into an application. When using FusionAuth’s SSO or your own, you should call this if the user is already logged in centrally, but accesses an application where they no longer have a session. This helps correctly track login counts, times and helps with reporting.
|
599
|
+
|
600
|
+
@param request [OpenStruct, Hash] The login request that contains the user credentials used to log them in. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
601
|
+
|
602
|
+
### logout(global, refresh_token) [](#method-i-logout)
|
603
|
+
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
|
+
|
605
|
+
@param global [Boolean] When this value is set to true all of the refresh tokens issued to the owner of the
|
606
|
+
|
607
|
+
```
|
608
|
+
provided token will be revoked.
|
609
|
+
```
|
610
|
+
|
611
|
+
@param refresh\_token [string] (Optional) The refresh\_token as a request parameter instead of coming in via a cookie.
|
612
|
+
|
613
|
+
```
|
614
|
+
If provided this takes precedence over the cookie.
|
615
|
+
```
|
616
|
+
|
617
|
+
@return [FusionAuth::ClientResponse] The ClientResponse object.
|
618
|
+
|
619
|
+
### logout_with_request(request) [](#method-i-logout_with_request)
|
620
|
+
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 takes the refresh token in the JSON body.
|
621
|
+
|
622
|
+
@param request [OpenStruct, Hash] The request object that contains all the information used to logout the user. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
623
|
+
|
624
|
+
### lookup_identity_provider(domain) [](#method-i-lookup_identity_provider)
|
625
|
+
Retrieves the identity provider for the given domain. A 200 response code indicates the domain is managed by a registered identity provider. A 404 indicates the domain is not managed.
|
626
|
+
|
627
|
+
@param domain [string] The domain or email address to lookup. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
628
|
+
|
629
|
+
### modify_action(action_id, request) [](#method-i-modify_action)
|
630
|
+
Modifies a temporal user action by changing the expiration of the action and optionally adding a comment to the action.
|
631
|
+
|
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.
|
633
|
+
|
634
|
+
### passwordless_login(request) [](#method-i-passwordless_login)
|
635
|
+
Complete a login request using a passwordless code
|
636
|
+
|
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.
|
638
|
+
|
639
|
+
### patch_api_key(key_id, request) [](#method-i-patch_api_key)
|
640
|
+
Updates an authentication API key by given id
|
641
|
+
|
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.
|
643
|
+
|
644
|
+
### patch_application(application_id, request) [](#method-i-patch_application)
|
645
|
+
Updates, via PATCH, the application with the given Id.
|
646
|
+
|
647
|
+
@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
|
+
|
649
|
+
### 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.
|
651
|
+
|
652
|
+
@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
|
+
|
654
|
+
### patch_connector(connector_id, request) [](#method-i-patch_connector)
|
655
|
+
Updates, via PATCH, the connector with the given Id.
|
656
|
+
|
657
|
+
@param connector\_id [string] The Id of the connector to update. @param request [OpenStruct, Hash] The request that contains just the new connector information. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
658
|
+
|
659
|
+
### patch_consent(consent_id, request) [](#method-i-patch_consent)
|
660
|
+
Updates, via PATCH, the consent with the given Id.
|
661
|
+
|
662
|
+
@param consent\_id [string] The Id of the consent to update. @param request [OpenStruct, Hash] The request that contains just the new consent information. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
663
|
+
|
664
|
+
### patch_email_template(email_template_id, request) [](#method-i-patch_email_template)
|
665
|
+
Updates, via PATCH, the email template with the given Id.
|
666
|
+
|
667
|
+
@param email\_template\_id [string] The Id of the email template to update. @param request [OpenStruct, Hash] The request that contains just the new email template information. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
668
|
+
|
669
|
+
### patch_entity_type(entity_type_id, request) [](#method-i-patch_entity_type)
|
670
|
+
Updates, via PATCH, the Entity Type with the given Id.
|
671
|
+
|
672
|
+
@param entity\_type\_id [string] The Id of the Entity Type to update. @param request [OpenStruct, Hash] The request that contains just the new Entity Type information. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
673
|
+
|
674
|
+
### patch_group(group_id, request) [](#method-i-patch_group)
|
675
|
+
Updates, via PATCH, the group with the given Id.
|
676
|
+
|
677
|
+
@param group\_id [string] The Id of the group to update. @param request [OpenStruct, Hash] The request that contains just the new group information. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
678
|
+
|
679
|
+
### patch_identity_provider(identity_provider_id, request) [](#method-i-patch_identity_provider)
|
680
|
+
Updates, via PATCH, the identity provider with the given Id.
|
681
|
+
|
682
|
+
@param identity\_provider\_id [string] The Id of the identity provider to update. @param request [OpenStruct, Hash] The request object that contains just the updated identity provider information. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
683
|
+
|
684
|
+
### patch_integrations(request) [](#method-i-patch_integrations)
|
685
|
+
Updates, via PATCH, the available integrations.
|
686
|
+
|
687
|
+
@param request [OpenStruct, Hash] The request that contains just the new integration information. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
688
|
+
|
689
|
+
### patch_lambda(lambda_id, request) [](#method-i-patch_lambda)
|
690
|
+
Updates, via PATCH, the lambda with the given Id.
|
691
|
+
|
692
|
+
@param lambda\_id [string] The Id of the lambda to update. @param request [OpenStruct, Hash] The request that contains just the new lambda information. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
693
|
+
|
694
|
+
### patch_message_template(message_template_id, request) [](#method-i-patch_message_template)
|
695
|
+
Updates, via PATCH, the message template with the given Id.
|
696
|
+
|
697
|
+
@param message\_template\_id [string] The Id of the message template to update. @param request [OpenStruct, Hash] The request that contains just the new message template information. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
698
|
+
|
699
|
+
### patch_messenger(messenger_id, request) [](#method-i-patch_messenger)
|
700
|
+
Updates, via PATCH, the messenger with the given Id.
|
701
|
+
|
702
|
+
@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
|
+
|
704
|
+
### 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.
|
706
|
+
|
707
|
+
@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
|
+
|
709
|
+
### patch_system_configuration(request) [](#method-i-patch_system_configuration)
|
710
|
+
Updates, via PATCH, the system configuration.
|
711
|
+
|
712
|
+
@param request [OpenStruct, Hash] The request that contains just the new system configuration information. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
713
|
+
|
714
|
+
### patch_tenant(tenant_id, request) [](#method-i-patch_tenant)
|
715
|
+
Updates, via PATCH, the tenant with the given Id.
|
716
|
+
|
717
|
+
@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 just the new tenant information. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
718
|
+
|
719
|
+
### patch_theme(theme_id, request) [](#method-i-patch_theme)
|
720
|
+
Updates, via PATCH, the theme with the given Id.
|
721
|
+
|
722
|
+
@param theme\_id [string] The Id of the theme to update. @param request [OpenStruct, Hash] The request that contains just the new theme information. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
723
|
+
|
724
|
+
### patch_user(user_id, request) [](#method-i-patch_user)
|
725
|
+
Updates, via PATCH, the user with the given Id.
|
726
|
+
|
727
|
+
@param user\_id [string] The Id of the user to update. @param request [OpenStruct, Hash] The request that contains just the new user information. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
728
|
+
|
729
|
+
### patch_user_action(user_action_id, request) [](#method-i-patch_user_action)
|
730
|
+
Updates, via PATCH, the user action with the given Id.
|
731
|
+
|
732
|
+
@param user\_action\_id [string] The Id of the user action to update. @param request [OpenStruct, Hash] The request that contains just the new user action information. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
733
|
+
|
734
|
+
### patch_user_action_reason(user_action_reason_id, request) [](#method-i-patch_user_action_reason)
|
735
|
+
Updates, via PATCH, the user action reason with the given Id.
|
736
|
+
|
737
|
+
@param user\_action\_reason\_id [string] The Id of the user action reason to update. @param request [OpenStruct, Hash] The request that contains just the new user action reason information. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
738
|
+
|
739
|
+
### patch_user_consent(user_consent_id, request) [](#method-i-patch_user_consent)
|
740
|
+
Updates, via PATCH, a single User consent by Id.
|
741
|
+
|
742
|
+
@param user\_consent\_id [string] The User Consent Id @param request [OpenStruct, Hash] The request that contains just the new user consent information. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
743
|
+
|
744
|
+
### reactivate_application(application_id) [](#method-i-reactivate_application)
|
745
|
+
Reactivates the application with the given Id.
|
746
|
+
|
747
|
+
@param application\_id [string] The Id of the application to reactivate. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
748
|
+
|
749
|
+
### reactivate_user(user_id) [](#method-i-reactivate_user)
|
750
|
+
Reactivates the user with the given Id.
|
751
|
+
|
752
|
+
@param user\_id [string] The Id of the user to reactivate. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
753
|
+
|
754
|
+
### reactivate_user_action(user_action_id) [](#method-i-reactivate_user_action)
|
755
|
+
Reactivates the user action with the given Id.
|
756
|
+
|
757
|
+
@param user\_action\_id [string] The Id of the user action to reactivate. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
758
|
+
|
759
|
+
### reconcile_jwt(request) [](#method-i-reconcile_jwt)
|
760
|
+
Reconcile a User to [`FusionAuth`](../FusionAuth.html) using JWT issued from another Identity Provider.
|
761
|
+
|
762
|
+
@param request [OpenStruct, Hash] The reconcile request that contains the data to reconcile the User. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
763
|
+
|
764
|
+
### refresh_entity_search_index() [](#method-i-refresh_entity_search_index)
|
765
|
+
Request a refresh of the Entity search index. This API is not generally necessary and the search index will become consistent in a reasonable amount of time. There may be scenarios where you may wish to manually request an index refresh. One example may be if you are using the Search API or Delete Tenant API immediately following a Entity Create etc, you may wish to request a refresh to
|
766
|
+
|
767
|
+
```
|
768
|
+
ensure the index immediately current before making a query request to the search index.
|
769
|
+
```
|
770
|
+
|
771
|
+
@return [FusionAuth::ClientResponse] The ClientResponse object.
|
772
|
+
|
773
|
+
### refresh_user_search_index() [](#method-i-refresh_user_search_index)
|
774
|
+
Request a refresh of the User search index. This API is not generally necessary and the search index will become consistent in a reasonable amount of time. There may be scenarios where you may wish to manually request an index refresh. One example may be if you are using the Search API or Delete Tenant API immediately following a User Create etc, you may wish to request a refresh to
|
775
|
+
|
776
|
+
```
|
777
|
+
ensure the index immediately current before making a query request to the search index.
|
778
|
+
```
|
779
|
+
|
780
|
+
@return [FusionAuth::ClientResponse] The ClientResponse object.
|
781
|
+
|
782
|
+
### regenerate_reactor_keys() [](#method-i-regenerate_reactor_keys)
|
783
|
+
Regenerates any keys that are used by the [`FusionAuth`](../FusionAuth.html) Reactor.
|
784
|
+
|
785
|
+
@return [FusionAuth::ClientResponse] The ClientResponse object.
|
786
|
+
|
787
|
+
### 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.
|
789
|
+
|
790
|
+
@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
|
+
|
792
|
+
### reindex(request) [](#method-i-reindex)
|
793
|
+
Requests Elasticsearch to delete and rebuild the index for [`FusionAuth`](../FusionAuth.html) users or entities. Be very careful when running this request as it will increase the CPU and I/O load on your database until the operation completes. Generally speaking you do not ever need to run this operation unless instructed by [`FusionAuth`](../FusionAuth.html) support, or if you are migrating a database another system and you are not brining along the Elasticsearch index.
|
794
|
+
|
795
|
+
You have been warned.
|
796
|
+
|
797
|
+
@param request [OpenStruct, Hash] The request that contains the index name. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
798
|
+
|
799
|
+
### remove_user_from_family(family_id, user_id) [](#method-i-remove_user_from_family)
|
800
|
+
Removes a user from the family with the given id.
|
801
|
+
|
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.
|
803
|
+
|
804
|
+
### resend_email_verification(email) [](#method-i-resend_email_verification)
|
805
|
+
Re-sends the verification email to the user.
|
806
|
+
|
807
|
+
@param email [string] The email address of the user that needs a new verification email. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
808
|
+
|
809
|
+
### resend_email_verification_with_application_template(application_id, email) [](#method-i-resend_email_verification_with_application_template)
|
810
|
+
Re-sends the verification email to the user. If the Application has configured a specific email template this will be used instead of the tenant configuration.
|
811
|
+
|
812
|
+
@param application\_id [string] The unique Application Id to used to resolve an application specific email template. @param email [string] The email address of the user that needs a new verification email. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
813
|
+
|
814
|
+
### resend_registration_verification(email, application_id) [](#method-i-resend_registration_verification)
|
815
|
+
Re-sends the application registration verification email to the user.
|
816
|
+
|
817
|
+
@param email [string] The email address of the user that needs a new verification email. @param application\_id [string] The Id of the application to be verified. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
818
|
+
|
819
|
+
### retrieve_action(action_id) [](#method-i-retrieve_action)
|
820
|
+
Retrieves a single action log (the log of a user action that was taken on a user previously) for the given Id.
|
821
|
+
|
822
|
+
@param action\_id [string] The Id of the action to retrieve. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
823
|
+
|
824
|
+
### retrieve_actions(user_id) [](#method-i-retrieve_actions)
|
825
|
+
Retrieves all the actions for the user with the given Id. This will return all time based actions that are active, and inactive as well as non-time based actions.
|
826
|
+
|
827
|
+
@param user\_id [string] The Id of the user to fetch the actions for. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
828
|
+
|
829
|
+
### retrieve_actions_preventing_login(user_id) [](#method-i-retrieve_actions_preventing_login)
|
830
|
+
Retrieves all the actions for the user with the given Id that are currently preventing the User from logging in.
|
831
|
+
|
832
|
+
@param user\_id [string] The Id of the user to fetch the actions for. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
833
|
+
|
834
|
+
### retrieve_active_actions(user_id) [](#method-i-retrieve_active_actions)
|
835
|
+
Retrieves all the actions for the user with the given Id that are currently active. An active action means one that is time based and has not been canceled, and has not ended.
|
836
|
+
|
837
|
+
@param user\_id [string] The Id of the user to fetch the actions for. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
838
|
+
|
839
|
+
### retrieve_api_key(key_id) [](#method-i-retrieve_api_key)
|
840
|
+
Retrieves an authentication API key for the given id
|
841
|
+
|
842
|
+
@param key\_id [string] The Id of the API key to retrieve. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
843
|
+
|
844
|
+
### 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.
|
846
|
+
|
847
|
+
@param application\_id [string] (Optional) The application id. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
848
|
+
|
849
|
+
### retrieve_applications() [](#method-i-retrieve_applications)
|
850
|
+
Retrieves all the applications.
|
851
|
+
|
852
|
+
@return [FusionAuth::ClientResponse] The ClientResponse object.
|
853
|
+
|
854
|
+
### retrieve_audit_log(audit_log_id) [](#method-i-retrieve_audit_log)
|
855
|
+
Retrieves a single audit log for the given Id.
|
856
|
+
|
857
|
+
@param audit\_log\_id [Numeric] The Id of the audit log to retrieve. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
858
|
+
|
859
|
+
### retrieve_connector(connector_id) [](#method-i-retrieve_connector)
|
860
|
+
Retrieves the connector with the given Id.
|
861
|
+
|
862
|
+
@param connector\_id [string] The Id of the connector. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
863
|
+
|
864
|
+
### retrieve_connectors() [](#method-i-retrieve_connectors)
|
865
|
+
Retrieves all the connectors.
|
866
|
+
|
867
|
+
@return [FusionAuth::ClientResponse] The ClientResponse object.
|
868
|
+
|
869
|
+
### retrieve_consent(consent_id) [](#method-i-retrieve_consent)
|
870
|
+
Retrieves the Consent for the given Id.
|
871
|
+
|
872
|
+
@param consent\_id [string] The Id of the consent. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
873
|
+
|
874
|
+
### retrieve_consents() [](#method-i-retrieve_consents)
|
875
|
+
Retrieves all the consent.
|
876
|
+
|
877
|
+
@return [FusionAuth::ClientResponse] The ClientResponse object.
|
878
|
+
|
879
|
+
### retrieve_daily_active_report(application_id, start, _end) [](#method-i-retrieve_daily_active_report)
|
880
|
+
Retrieves the daily active user report between the two instants. If you specify an application id, it will only return the daily active counts for that application.
|
881
|
+
|
882
|
+
@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
|
+
|
884
|
+
### 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.
|
886
|
+
|
887
|
+
@param email\_template\_id [string] (Optional) The Id of the email template. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
888
|
+
|
889
|
+
### retrieve_email_template_preview(request) [](#method-i-retrieve_email_template_preview)
|
890
|
+
Creates a preview of the email template provided in the request. This allows you to preview an email template that hasn’t been saved to the database yet. The entire email template does not need to be provided on the request. This will create the preview based on whatever is given.
|
891
|
+
|
892
|
+
@param request [OpenStruct, Hash] The request that contains the email template and optionally a locale to render it in. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
893
|
+
|
894
|
+
### retrieve_email_templates() [](#method-i-retrieve_email_templates)
|
895
|
+
Retrieves all the email templates.
|
896
|
+
|
897
|
+
@return [FusionAuth::ClientResponse] The ClientResponse object.
|
898
|
+
|
899
|
+
### retrieve_entity(entity_id) [](#method-i-retrieve_entity)
|
900
|
+
Retrieves the Entity for the given Id.
|
901
|
+
|
902
|
+
@param entity\_id [string] The Id of the Entity. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
903
|
+
|
904
|
+
### retrieve_entity_grant(entity_id, recipient_entity_id, user_id) [](#method-i-retrieve_entity_grant)
|
905
|
+
Retrieves an Entity Grant for the given Entity and User/Entity.
|
906
|
+
|
907
|
+
@param entity\_id [string] The Id of the Entity. @param recipient\_entity\_id [string] (Optional) The Id of the Entity that the Entity Grant is for. @param user\_id [string] (Optional) The Id of the User that the Entity Grant is for. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
908
|
+
|
909
|
+
### retrieve_entity_type(entity_type_id) [](#method-i-retrieve_entity_type)
|
910
|
+
Retrieves the Entity Type for the given Id.
|
911
|
+
|
912
|
+
@param entity\_type\_id [string] The Id of the Entity Type. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
913
|
+
|
914
|
+
### retrieve_entity_types() [](#method-i-retrieve_entity_types)
|
915
|
+
Retrieves all the Entity Types.
|
916
|
+
|
917
|
+
@return [FusionAuth::ClientResponse] The ClientResponse object.
|
918
|
+
|
919
|
+
### retrieve_event_log(event_log_id) [](#method-i-retrieve_event_log)
|
920
|
+
Retrieves a single event log for the given Id.
|
921
|
+
|
922
|
+
@param event\_log\_id [Numeric] The Id of the event log to retrieve. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
923
|
+
|
924
|
+
### retrieve_families(user_id) [](#method-i-retrieve_families)
|
925
|
+
Retrieves all the families that a user belongs to.
|
926
|
+
|
927
|
+
@param user\_id [string] The User’s id @return [FusionAuth::ClientResponse] The ClientResponse object.
|
928
|
+
|
929
|
+
### retrieve_family_members_by_family_id(family_id) [](#method-i-retrieve_family_members_by_family_id)
|
930
|
+
Retrieves all the members of a family by the unique Family Id.
|
931
|
+
|
932
|
+
@param family\_id [string] The unique Id of the Family. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
933
|
+
|
934
|
+
### retrieve_form(form_id) [](#method-i-retrieve_form)
|
935
|
+
Retrieves the form with the given Id.
|
936
|
+
|
937
|
+
@param form\_id [string] The Id of the form. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
938
|
+
|
939
|
+
### retrieve_form_field(field_id) [](#method-i-retrieve_form_field)
|
940
|
+
Retrieves the form field with the given Id.
|
941
|
+
|
942
|
+
@param field\_id [string] The Id of the form field. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
943
|
+
|
944
|
+
### retrieve_form_fields() [](#method-i-retrieve_form_fields)
|
945
|
+
Retrieves all the forms fields
|
946
|
+
|
947
|
+
@return [FusionAuth::ClientResponse] The ClientResponse object.
|
948
|
+
|
949
|
+
### retrieve_forms() [](#method-i-retrieve_forms)
|
950
|
+
Retrieves all the forms.
|
951
|
+
|
952
|
+
@return [FusionAuth::ClientResponse] The ClientResponse object.
|
953
|
+
|
954
|
+
### retrieve_group(group_id) [](#method-i-retrieve_group)
|
955
|
+
Retrieves the group for the given Id.
|
956
|
+
|
957
|
+
@param group\_id [string] The Id of the group. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
958
|
+
|
959
|
+
### retrieve_groups() [](#method-i-retrieve_groups)
|
960
|
+
Retrieves all the groups.
|
961
|
+
|
962
|
+
@return [FusionAuth::ClientResponse] The ClientResponse object.
|
963
|
+
|
964
|
+
### 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.
|
966
|
+
|
967
|
+
@param identity\_provider\_id [string] The identity provider Id. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
968
|
+
|
969
|
+
### retrieve_identity_provider_by_type(type) [](#method-i-retrieve_identity_provider_by_type)
|
970
|
+
Retrieves one or more identity provider for the given type. For types such as Google, Facebook, Twitter and LinkedIn, only a single identity provider can exist. For types such as OpenID Connect and SAMLv2 more than one identity provider can be configured so this request may return multiple identity providers.
|
971
|
+
|
972
|
+
@param type [OpenStruct, Hash] The type of the identity provider. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
973
|
+
|
974
|
+
### retrieve_identity_providers() [](#method-i-retrieve_identity_providers)
|
975
|
+
Retrieves all the identity providers.
|
976
|
+
|
977
|
+
@return [FusionAuth::ClientResponse] The ClientResponse object.
|
978
|
+
|
979
|
+
### retrieve_inactive_actions(user_id) [](#method-i-retrieve_inactive_actions)
|
980
|
+
Retrieves all the actions for the user with the given Id that are currently inactive. An inactive action means one that is time based and has been canceled or has expired, or is not time based.
|
981
|
+
|
982
|
+
@param user\_id [string] The Id of the user to fetch the actions for. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
983
|
+
|
984
|
+
### retrieve_inactive_applications() [](#method-i-retrieve_inactive_applications)
|
985
|
+
Retrieves all the applications that are currently inactive.
|
986
|
+
|
987
|
+
@return [FusionAuth::ClientResponse] The ClientResponse object.
|
988
|
+
|
989
|
+
### retrieve_inactive_user_actions() [](#method-i-retrieve_inactive_user_actions)
|
990
|
+
Retrieves all the user actions that are currently inactive.
|
991
|
+
|
992
|
+
@return [FusionAuth::ClientResponse] The ClientResponse object.
|
993
|
+
|
994
|
+
### retrieve_integration() [](#method-i-retrieve_integration)
|
995
|
+
Retrieves the available integrations.
|
996
|
+
|
997
|
+
@return [FusionAuth::ClientResponse] The ClientResponse object.
|
998
|
+
|
999
|
+
### retrieve_ip_access_control_list(ip_access_control_list_id) [](#method-i-retrieve_ip_access_control_list)
|
1000
|
+
Retrieves the IP Access Control List with the given Id.
|
1001
|
+
|
1002
|
+
@param ip\_access\_control\_list\_id [string] The Id of the IP Access Control List. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1003
|
+
|
1004
|
+
### retrieve_json_web_key_set() [](#method-i-retrieve_json_web_key_set)
|
1005
|
+
Returns public keys used by [`FusionAuth`](../FusionAuth.html) to cryptographically verify JWTs using the JSON Web Key format.
|
1006
|
+
|
1007
|
+
@return [FusionAuth::ClientResponse] The ClientResponse object.
|
1008
|
+
|
1009
|
+
### retrieve_jwt_public_key(key_id) [](#method-i-retrieve_jwt_public_key)
|
1010
|
+
Retrieves the Public Key configured for verifying JSON Web Tokens (JWT) by the key Id (kid).
|
1011
|
+
|
1012
|
+
@param key\_id [string] The Id of the public key (kid). @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1013
|
+
|
1014
|
+
### retrieve_jwt_public_key_by_application_id(application_id) [](#method-i-retrieve_jwt_public_key_by_application_id)
|
1015
|
+
Retrieves the Public Key configured for verifying the JSON Web Tokens (JWT) issued by the Login API by the Application Id.
|
1016
|
+
|
1017
|
+
@param application\_id [string] The Id of the Application for which this key is used. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1018
|
+
|
1019
|
+
### retrieve_jwt_public_keys() [](#method-i-retrieve_jwt_public_keys)
|
1020
|
+
Retrieves all Public Keys configured for verifying JSON Web Tokens (JWT).
|
1021
|
+
|
1022
|
+
@return [FusionAuth::ClientResponse] The ClientResponse object.
|
1023
|
+
|
1024
|
+
### retrieve_key(key_id) [](#method-i-retrieve_key)
|
1025
|
+
Retrieves the key for the given Id.
|
1026
|
+
|
1027
|
+
@param key\_id [string] The Id of the key. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1028
|
+
|
1029
|
+
### retrieve_keys() [](#method-i-retrieve_keys)
|
1030
|
+
Retrieves all the keys.
|
1031
|
+
|
1032
|
+
@return [FusionAuth::ClientResponse] The ClientResponse object.
|
1033
|
+
|
1034
|
+
### retrieve_lambda(lambda_id) [](#method-i-retrieve_lambda)
|
1035
|
+
Retrieves the lambda for the given Id.
|
1036
|
+
|
1037
|
+
@param lambda\_id [string] The Id of the lambda. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1038
|
+
|
1039
|
+
### retrieve_lambdas() [](#method-i-retrieve_lambdas)
|
1040
|
+
Retrieves all the lambdas.
|
1041
|
+
|
1042
|
+
@return [FusionAuth::ClientResponse] The ClientResponse object.
|
1043
|
+
|
1044
|
+
### retrieve_lambdas_by_type(type) [](#method-i-retrieve_lambdas_by_type)
|
1045
|
+
Retrieves all the lambdas for the provided type.
|
1046
|
+
|
1047
|
+
@param type [OpenStruct, Hash] The type of the lambda to return. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1048
|
+
|
1049
|
+
### retrieve_login_report(application_id, start, _end) [](#method-i-retrieve_login_report)
|
1050
|
+
Retrieves the login report between the two instants. If you specify an application id, it will only return the login counts for that application.
|
1051
|
+
|
1052
|
+
@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
|
+
|
1054
|
+
### 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.
|
1056
|
+
|
1057
|
+
@param message\_template\_id [string] (Optional) The Id of the message template. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1058
|
+
|
1059
|
+
### retrieve_message_template_preview(request) [](#method-i-retrieve_message_template_preview)
|
1060
|
+
Creates a preview of the message template provided in the request, normalized to a given locale.
|
1061
|
+
|
1062
|
+
@param request [OpenStruct, Hash] The request that contains the email template and optionally a locale to render it in. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1063
|
+
|
1064
|
+
### retrieve_message_templates() [](#method-i-retrieve_message_templates)
|
1065
|
+
Retrieves all the message templates.
|
1066
|
+
|
1067
|
+
@return [FusionAuth::ClientResponse] The ClientResponse object.
|
1068
|
+
|
1069
|
+
### retrieve_messenger(messenger_id) [](#method-i-retrieve_messenger)
|
1070
|
+
Retrieves the messenger with the given Id.
|
1071
|
+
|
1072
|
+
@param messenger\_id [string] The Id of the messenger. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1073
|
+
|
1074
|
+
### retrieve_messengers() [](#method-i-retrieve_messengers)
|
1075
|
+
Retrieves all the messengers.
|
1076
|
+
|
1077
|
+
@return [FusionAuth::ClientResponse] The ClientResponse object.
|
1078
|
+
|
1079
|
+
### retrieve_monthly_active_report(application_id, start, _end) [](#method-i-retrieve_monthly_active_report)
|
1080
|
+
Retrieves the monthly active user report between the two instants. If you specify an application id, it will only return the monthly active counts for that application.
|
1081
|
+
|
1082
|
+
@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.
|
1083
|
+
|
1084
|
+
### retrieve_oauth_configuration(application_id) [](#method-i-retrieve_oauth_configuration)
|
1085
|
+
Retrieves the Oauth2 configuration for the application for the given Application Id.
|
1086
|
+
|
1087
|
+
@param application\_id [string] The Id of the Application to retrieve OAuth configuration. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1088
|
+
|
1089
|
+
### retrieve_open_id_configuration() [](#method-i-retrieve_open_id_configuration)
|
1090
|
+
Returns the well known OpenID Configuration JSON document
|
1091
|
+
|
1092
|
+
@return [FusionAuth::ClientResponse] The ClientResponse object.
|
1093
|
+
|
1094
|
+
### retrieve_password_validation_rules() [](#method-i-retrieve_password_validation_rules)
|
1095
|
+
Retrieves the password validation rules for a specific tenant. This method requires a tenantId to be provided through the use of a Tenant scoped API key or an HTTP header X-FusionAuth-TenantId to specify the Tenant Id.
|
1096
|
+
|
1097
|
+
This API does not require an API key.
|
1098
|
+
|
1099
|
+
@return [FusionAuth::ClientResponse] The ClientResponse object.
|
1100
|
+
|
1101
|
+
### retrieve_password_validation_rules_with_tenant_id(tenant_id) [](#method-i-retrieve_password_validation_rules_with_tenant_id)
|
1102
|
+
Retrieves the password validation rules for a specific tenant.
|
1103
|
+
|
1104
|
+
This API does not require an API key.
|
1105
|
+
|
1106
|
+
@param [`tenant_id`](FusionAuthClient.html#attribute-i-tenant_id) [string] The Id of the tenant. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1107
|
+
|
1108
|
+
### retrieve_pending_children(parent_email) [](#method-i-retrieve_pending_children)
|
1109
|
+
Retrieves all the children for the given parent email address.
|
1110
|
+
|
1111
|
+
@param parent\_email [string] The email of the parent. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1112
|
+
|
1113
|
+
### retrieve_reactor_metrics() [](#method-i-retrieve_reactor_metrics)
|
1114
|
+
Retrieves the [`FusionAuth`](../FusionAuth.html) Reactor metrics.
|
1115
|
+
|
1116
|
+
@return [FusionAuth::ClientResponse] The ClientResponse object.
|
1117
|
+
|
1118
|
+
### retrieve_reactor_status() [](#method-i-retrieve_reactor_status)
|
1119
|
+
Retrieves the [`FusionAuth`](../FusionAuth.html) Reactor status.
|
1120
|
+
|
1121
|
+
@return [FusionAuth::ClientResponse] The ClientResponse object.
|
1122
|
+
|
1123
|
+
### retrieve_recent_logins(offset, limit) [](#method-i-retrieve_recent_logins)
|
1124
|
+
Retrieves the last number of login records.
|
1125
|
+
|
1126
|
+
@param offset [Numeric] The initial record. e.g. 0 is the last login, 100 will be the 100th most recent login. @param limit [Numeric] (Optional, defaults to 10) The number of records to retrieve. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1127
|
+
|
1128
|
+
### retrieve_refresh_token_by_id(token_id) [](#method-i-retrieve_refresh_token_by_id)
|
1129
|
+
Retrieves a single refresh token by unique Id. This is not the same thing as the string value of the refresh token. If you have that, you already have what you need.
|
1130
|
+
|
1131
|
+
@param token\_id [string] The Id of the token. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1132
|
+
|
1133
|
+
### retrieve_refresh_tokens(user_id) [](#method-i-retrieve_refresh_tokens)
|
1134
|
+
Retrieves the refresh tokens that belong to the user with the given Id.
|
1135
|
+
|
1136
|
+
@param user\_id [string] The Id of the user. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1137
|
+
|
1138
|
+
### 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.
|
1140
|
+
|
1141
|
+
@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
|
+
|
1143
|
+
### retrieve_registration_report(application_id, start, _end) [](#method-i-retrieve_registration_report)
|
1144
|
+
Retrieves the registration report between the two instants. If you specify an application id, it will only return the registration counts for that application.
|
1145
|
+
|
1146
|
+
@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.
|
1147
|
+
|
1148
|
+
### retrieve_reindex_status() [](#method-i-retrieve_reindex_status)
|
1149
|
+
Retrieve the status of a re-index process. A status code of 200 indicates the re-index is in progress, a status code of
|
1150
|
+
|
1151
|
+
404 indicates no re-index is in progress.
|
1152
|
+
|
1153
|
+
@return [FusionAuth::ClientResponse] The ClientResponse object.
|
1154
|
+
|
1155
|
+
### retrieve_system_configuration() [](#method-i-retrieve_system_configuration)
|
1156
|
+
Retrieves the system configuration.
|
1157
|
+
|
1158
|
+
@return [FusionAuth::ClientResponse] The ClientResponse object.
|
1159
|
+
|
1160
|
+
### retrieve_tenant(tenant_id) [](#method-i-retrieve_tenant)
|
1161
|
+
Retrieves the tenant for the given Id.
|
1162
|
+
|
1163
|
+
@param [`tenant_id`](FusionAuthClient.html#attribute-i-tenant_id) [string] The Id of the tenant. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1164
|
+
|
1165
|
+
### retrieve_tenants() [](#method-i-retrieve_tenants)
|
1166
|
+
Retrieves all the tenants.
|
1167
|
+
|
1168
|
+
@return [FusionAuth::ClientResponse] The ClientResponse object.
|
1169
|
+
|
1170
|
+
### retrieve_theme(theme_id) [](#method-i-retrieve_theme)
|
1171
|
+
Retrieves the theme for the given Id.
|
1172
|
+
|
1173
|
+
@param theme\_id [string] The Id of the theme. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1174
|
+
|
1175
|
+
### retrieve_themes() [](#method-i-retrieve_themes)
|
1176
|
+
Retrieves all the themes.
|
1177
|
+
|
1178
|
+
@return [FusionAuth::ClientResponse] The ClientResponse object.
|
1179
|
+
|
1180
|
+
### 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.
|
1182
|
+
|
1183
|
+
@return [FusionAuth::ClientResponse] The ClientResponse object.
|
1184
|
+
|
1185
|
+
### retrieve_two_factor_recovery_codes(user_id) [](#method-i-retrieve_two_factor_recovery_codes)
|
1186
|
+
Retrieve two-factor recovery codes for a user.
|
1187
|
+
|
1188
|
+
@param user\_id [string] The Id of the user to retrieve Two Factor recovery codes. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1189
|
+
|
1190
|
+
### retrieve_two_factor_status(user_id, application_id, two_factor_trust_id) [](#method-i-retrieve_two_factor_status)
|
1191
|
+
Retrieve a user’s two-factor status.
|
1192
|
+
|
1193
|
+
This can be used to see if a user will need to complete a two-factor challenge to complete a login, and optionally identify the state of the two-factor trust across various applications.
|
1194
|
+
|
1195
|
+
@param user\_id [string] The user Id to retrieve the Two-Factor status. @param application\_id [string] The optional applicationId to verify. @param two\_factor\_trust\_id [string] The optional two-factor trust Id to verify. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1196
|
+
|
1197
|
+
### retrieve_user(user_id) [](#method-i-retrieve_user)
|
1198
|
+
Retrieves the user for the given Id.
|
1199
|
+
|
1200
|
+
@param user\_id [string] The Id of the user. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1201
|
+
|
1202
|
+
### 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.
|
1204
|
+
|
1205
|
+
@param user\_action\_id [string] (Optional) The Id of the user action. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1206
|
+
|
1207
|
+
### 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.
|
1209
|
+
|
1210
|
+
@param user\_action\_reason\_id [string] (Optional) The Id of the user action reason. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1211
|
+
|
1212
|
+
### retrieve_user_action_reasons() [](#method-i-retrieve_user_action_reasons)
|
1213
|
+
Retrieves all the user action reasons.
|
1214
|
+
|
1215
|
+
@return [FusionAuth::ClientResponse] The ClientResponse object.
|
1216
|
+
|
1217
|
+
### retrieve_user_actions() [](#method-i-retrieve_user_actions)
|
1218
|
+
Retrieves all the user actions.
|
1219
|
+
|
1220
|
+
@return [FusionAuth::ClientResponse] The ClientResponse object.
|
1221
|
+
|
1222
|
+
### retrieve_user_by_change_password_id(change_password_id) [](#method-i-retrieve_user_by_change_password_id)
|
1223
|
+
Retrieves the user by a change password Id. The intended use of this API is to retrieve a user after the forgot password workflow has been initiated and you may not know the user’s email or username.
|
1224
|
+
|
1225
|
+
@param change\_password\_id [string] The unique change password Id that was sent via email or returned by the Forgot Password API. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1226
|
+
|
1227
|
+
### retrieve_user_by_email(email) [](#method-i-retrieve_user_by_email)
|
1228
|
+
Retrieves the user for the given email.
|
1229
|
+
|
1230
|
+
@param email [string] The email of the user. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1231
|
+
|
1232
|
+
### retrieve_user_by_login_id(login_id) [](#method-i-retrieve_user_by_login_id)
|
1233
|
+
Retrieves the user for the loginId. The loginId can be either the username or the email.
|
1234
|
+
|
1235
|
+
@param login\_id [string] The email or username of the user. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1236
|
+
|
1237
|
+
### retrieve_user_by_username(username) [](#method-i-retrieve_user_by_username)
|
1238
|
+
Retrieves the user for the given username.
|
1239
|
+
|
1240
|
+
@param username [string] The username of the user. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1241
|
+
|
1242
|
+
### retrieve_user_by_verification_id(verification_id) [](#method-i-retrieve_user_by_verification_id)
|
1243
|
+
Retrieves the user by a verificationId. The intended use of this API is to retrieve a user after the forgot password workflow has been initiated and you may not know the user’s email or username.
|
1244
|
+
|
1245
|
+
@param verification\_id [string] The unique verification Id that has been set on the user object. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1246
|
+
|
1247
|
+
### retrieve_user_comments(user_id) [](#method-i-retrieve_user_comments)
|
1248
|
+
Retrieves all the comments for the user with the given Id.
|
1249
|
+
|
1250
|
+
@param user\_id [string] The Id of the user. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1251
|
+
|
1252
|
+
### retrieve_user_consent(user_consent_id) [](#method-i-retrieve_user_consent)
|
1253
|
+
Retrieve a single User consent by Id.
|
1254
|
+
|
1255
|
+
@param user\_consent\_id [string] The User consent Id @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1256
|
+
|
1257
|
+
### retrieve_user_consents(user_id) [](#method-i-retrieve_user_consents)
|
1258
|
+
Retrieves all the consents for a User.
|
1259
|
+
|
1260
|
+
@param user\_id [string] The User’s Id @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1261
|
+
|
1262
|
+
### retrieve_user_info_from_access_token(encoded_jwt) [](#method-i-retrieve_user_info_from_access_token)
|
1263
|
+
Call the UserInfo endpoint to retrieve User Claims from the access token issued by [`FusionAuth`](../FusionAuth.html).
|
1264
|
+
|
1265
|
+
@param encoded\_jwt [string] The encoded JWT (access token). @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1266
|
+
|
1267
|
+
### retrieve_user_link(identity_provider_id, identity_provider_user_id, user_id) [](#method-i-retrieve_user_link)
|
1268
|
+
Retrieve a single Identity Provider user (link).
|
1269
|
+
|
1270
|
+
@param identity\_provider\_id [string] The unique Id of the identity provider. @param identity\_provider\_user\_id [string] The unique Id of the user in the 3rd party identity provider. @param user\_id [string] The unique Id of the [`FusionAuth`](../FusionAuth.html) user. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1271
|
+
|
1272
|
+
### retrieve_user_links_by_user_id(identity_provider_id, user_id) [](#method-i-retrieve_user_links_by_user_id)
|
1273
|
+
Retrieve all Identity Provider users (links) for the user. Specify the optional identityProviderId to retrieve links for a particular IdP.
|
1274
|
+
|
1275
|
+
@param identity\_provider\_id [string] (Optional) The unique Id of the identity provider. Specify this value to reduce the links returned to those for a particular IdP. @param user\_id [string] The unique Id of the user. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1276
|
+
|
1277
|
+
### retrieve_user_login_report(application_id, user_id, start, _end) [](#method-i-retrieve_user_login_report)
|
1278
|
+
Retrieves the login report between the two instants for a particular user by Id. If you specify an application id, it will only return the login counts for that application.
|
1279
|
+
|
1280
|
+
@param application\_id [string] (Optional) The application id. @param user\_id [string] The userId id. @param start [OpenStruct, Hash] The start instant as UTC milliseconds since Epoch. @param \_end [OpenStruct, Hash] The end instant as UTC milliseconds since Epoch. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1281
|
+
|
1282
|
+
### retrieve_user_login_report_by_login_id(application_id, login_id, start, _end) [](#method-i-retrieve_user_login_report_by_login_id)
|
1283
|
+
Retrieves the login report between the two instants for a particular user by login Id. If you specify an application id, it will only return the login counts for that application.
|
1284
|
+
|
1285
|
+
@param application\_id [string] (Optional) The application id. @param login\_id [string] The userId id. @param start [OpenStruct, Hash] The start instant as UTC milliseconds since Epoch. @param \_end [OpenStruct, Hash] The end instant as UTC milliseconds since Epoch. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1286
|
+
|
1287
|
+
### retrieve_user_recent_logins(user_id, offset, limit) [](#method-i-retrieve_user_recent_logins)
|
1288
|
+
Retrieves the last number of login records for a user.
|
1289
|
+
|
1290
|
+
@param user\_id [string] The Id of the user. @param offset [Numeric] The initial record. e.g. 0 is the last login, 100 will be the 100th most recent login. @param limit [Numeric] (Optional, defaults to 10) The number of records to retrieve. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1291
|
+
|
1292
|
+
### retrieve_user_using_jwt(encoded_jwt) [](#method-i-retrieve_user_using_jwt)
|
1293
|
+
Retrieves the user for the given Id. This method does not use an API key, instead it uses a JSON Web Token (JWT) for authentication.
|
1294
|
+
|
1295
|
+
@param encoded\_jwt [string] The encoded JWT (access token). @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1296
|
+
|
1297
|
+
### retrieve_version() [](#method-i-retrieve_version)
|
1298
|
+
Retrieves the [`FusionAuth`](../FusionAuth.html) version string.
|
1299
|
+
|
1300
|
+
@return [FusionAuth::ClientResponse] The ClientResponse object.
|
1301
|
+
|
1302
|
+
### retrieve_web_authn_credential(id) [](#method-i-retrieve_web_authn_credential)
|
1303
|
+
Retrieves the WebAuthn credential for the given Id.
|
1304
|
+
|
1305
|
+
@param id [string] The Id of the WebAuthn credential. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1306
|
+
|
1307
|
+
### retrieve_web_authn_credentials_for_user(user_id) [](#method-i-retrieve_web_authn_credentials_for_user)
|
1308
|
+
Retrieves all WebAuthn credentials for the given user.
|
1309
|
+
|
1310
|
+
@param user\_id [string] The user’s ID. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1311
|
+
|
1312
|
+
### retrieve_webhook(webhook_id) [](#method-i-retrieve_webhook)
|
1313
|
+
Retrieves the webhook for the given Id. If you pass in null for the id, this will return all the webhooks.
|
1314
|
+
|
1315
|
+
@param webhook\_id [string] (Optional) The Id of the webhook. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1316
|
+
|
1317
|
+
### retrieve_webhooks() [](#method-i-retrieve_webhooks)
|
1318
|
+
Retrieves all the webhooks.
|
1319
|
+
|
1320
|
+
@return [FusionAuth::ClientResponse] The ClientResponse object.
|
1321
|
+
|
1322
|
+
### revoke_refresh_token(token, user_id, application_id) [](#method-i-revoke_refresh_token)
|
1323
|
+
Revokes refresh tokens.
|
1324
|
+
|
1325
|
+
Usage examples:
|
1326
|
+
|
1327
|
+
```
|
1328
|
+
- Delete a single refresh token, pass in only the token.
|
1329
|
+
revokeRefreshToken(token)
|
1330
|
+
|
1331
|
+
- Delete all refresh tokens for a user, pass in only the userId.
|
1332
|
+
revokeRefreshToken(null, userId)
|
1333
|
+
|
1334
|
+
- Delete all refresh tokens for a user for a specific application, pass in both the userId and the applicationId.
|
1335
|
+
revokeRefreshToken(null, userId, applicationId)
|
1336
|
+
|
1337
|
+
- Delete all refresh tokens for an application
|
1338
|
+
revokeRefreshToken(null, null, applicationId)
|
1339
|
+
```
|
1340
|
+
|
1341
|
+
Note: `null` may be handled differently depending upon the programming language.
|
1342
|
+
|
1343
|
+
See also: (method names may vary by language… but you’ll figure it out)
|
1344
|
+
|
1345
|
+
```
|
1346
|
+
-revokeRefreshTokenById-revokeRefreshTokenByToken-revokeRefreshTokensByUserId-revokeRefreshTokensByApplicationId-revokeRefreshTokensByUserIdForApplication
|
1347
|
+
```
|
1348
|
+
|
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.
|
1350
|
+
|
1351
|
+
### revoke_refresh_token_by_id(token_id) [](#method-i-revoke_refresh_token_by_id)
|
1352
|
+
Revokes a single refresh token by the unique Id. The unique Id is not sensitive as it cannot be used to obtain another JWT.
|
1353
|
+
|
1354
|
+
@param token\_id [string] The unique Id of the token to delete. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1355
|
+
|
1356
|
+
### revoke_refresh_token_by_token(token) [](#method-i-revoke_refresh_token_by_token)
|
1357
|
+
Revokes a single refresh token by using the actual refresh token value. This refresh token value is sensitive, so be careful with this API request.
|
1358
|
+
|
1359
|
+
@param token [string] The refresh token to delete. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1360
|
+
|
1361
|
+
### revoke_refresh_tokens_by_application_id(application_id) [](#method-i-revoke_refresh_tokens_by_application_id)
|
1362
|
+
Revoke all refresh tokens that belong to an application by applicationId.
|
1363
|
+
|
1364
|
+
@param application\_id [string] The unique Id of the application that you want to delete all refresh tokens for. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1365
|
+
|
1366
|
+
### revoke_refresh_tokens_by_user_id(user_id) [](#method-i-revoke_refresh_tokens_by_user_id)
|
1367
|
+
Revoke all refresh tokens that belong to a user by user Id.
|
1368
|
+
|
1369
|
+
@param user\_id [string] The unique Id of the user that you want to delete all refresh tokens for. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1370
|
+
|
1371
|
+
### revoke_refresh_tokens_by_user_id_for_application(user_id, application_id) [](#method-i-revoke_refresh_tokens_by_user_id_for_application)
|
1372
|
+
Revoke all refresh tokens that belong to a user by user Id for a specific application by applicationId.
|
1373
|
+
|
1374
|
+
@param user\_id [string] The unique Id of the user that you want to delete all refresh tokens for. @param application\_id [string] The unique Id of the application that you want to delete refresh tokens for. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1375
|
+
|
1376
|
+
### revoke_refresh_tokens_with_request(request) [](#method-i-revoke_refresh_tokens_with_request)
|
1377
|
+
Revokes refresh tokens using the information in the JSON body. The handling for this method is the same as the revokeRefreshToken method and is based on the information you provide in the RefreshDeleteRequest object. See that method for additional information.
|
1378
|
+
|
1379
|
+
@param request [OpenStruct, Hash] The request information used to revoke the refresh tokens. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1380
|
+
|
1381
|
+
### revoke_user_consent(user_consent_id) [](#method-i-revoke_user_consent)
|
1382
|
+
Revokes a single User consent by Id.
|
1383
|
+
|
1384
|
+
@param user\_consent\_id [string] The User Consent Id @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1385
|
+
|
1386
|
+
### search_audit_logs(request) [](#method-i-search_audit_logs)
|
1387
|
+
Searches the audit logs with the specified criteria and pagination.
|
1388
|
+
|
1389
|
+
@param request [OpenStruct, Hash] The search criteria and pagination information. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1390
|
+
|
1391
|
+
### search_entities(request) [](#method-i-search_entities)
|
1392
|
+
Searches entities with the specified criteria and pagination.
|
1393
|
+
|
1394
|
+
@param request [OpenStruct, Hash] The search criteria and pagination information. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1395
|
+
|
1396
|
+
### 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.
|
1398
|
+
|
1399
|
+
@param ids [Array] The entity ids to search for. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1400
|
+
|
1401
|
+
### search_entity_grants(request) [](#method-i-search_entity_grants)
|
1402
|
+
Searches Entity Grants with the specified criteria and pagination.
|
1403
|
+
|
1404
|
+
@param request [OpenStruct, Hash] The search criteria and pagination information. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1405
|
+
|
1406
|
+
### search_entity_types(request) [](#method-i-search_entity_types)
|
1407
|
+
Searches the entity types with the specified criteria and pagination.
|
1408
|
+
|
1409
|
+
@param request [OpenStruct, Hash] The search criteria and pagination information. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1410
|
+
|
1411
|
+
### search_event_logs(request) [](#method-i-search_event_logs)
|
1412
|
+
Searches the event logs with the specified criteria and pagination.
|
1413
|
+
|
1414
|
+
@param request [OpenStruct, Hash] The search criteria and pagination information. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1415
|
+
|
1416
|
+
### search_group_members(request) [](#method-i-search_group_members)
|
1417
|
+
Searches group members with the specified criteria and pagination.
|
1418
|
+
|
1419
|
+
@param request [OpenStruct, Hash] The search criteria and pagination information. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1420
|
+
|
1421
|
+
### search_groups(request) [](#method-i-search_groups)
|
1422
|
+
Searches groups with the specified criteria and pagination.
|
1423
|
+
|
1424
|
+
@param request [OpenStruct, Hash] The search criteria and pagination information. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1425
|
+
|
1426
|
+
### search_ip_access_control_lists(request) [](#method-i-search_ip_access_control_lists)
|
1427
|
+
Searches the IP Access Control Lists with the specified criteria and pagination.
|
1428
|
+
|
1429
|
+
@param request [OpenStruct, Hash] The search criteria and pagination information. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1430
|
+
|
1431
|
+
### search_login_records(request) [](#method-i-search_login_records)
|
1432
|
+
Searches the login records with the specified criteria and pagination.
|
1433
|
+
|
1434
|
+
@param request [OpenStruct, Hash] The search criteria and pagination information. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1435
|
+
|
1436
|
+
### search_users(ids) [](#method-i-search_users)
|
1437
|
+
Retrieves the users for the given ids. If any id is invalid, it is ignored.
|
1438
|
+
|
1439
|
+
@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
|
+
|
1441
|
+
### 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.
|
1443
|
+
|
1444
|
+
@param ids [Array] The user ids to search for. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1445
|
+
|
1446
|
+
### search_users_by_query(request) [](#method-i-search_users_by_query)
|
1447
|
+
Retrieves the users for the given search criteria and pagination.
|
1448
|
+
|
1449
|
+
@param request [OpenStruct, Hash] The search criteria and pagination constraints. Fields used: ids, query, queryString, numberOfResults, orderBy, startRow,
|
1450
|
+
|
1451
|
+
```
|
1452
|
+
and sortFields.
|
1453
|
+
```
|
1454
|
+
|
1455
|
+
@return [FusionAuth::ClientResponse] The ClientResponse object.
|
1456
|
+
|
1457
|
+
### search_users_by_query_string(request) [](#method-i-search_users_by_query_string)
|
1458
|
+
Retrieves the users for the given search criteria and pagination.
|
1459
|
+
|
1460
|
+
@param request [OpenStruct, Hash] The search criteria and pagination constraints. Fields used: ids, query, queryString, numberOfResults, orderBy, startRow,
|
1461
|
+
|
1462
|
+
```
|
1463
|
+
and sortFields.
|
1464
|
+
```
|
1465
|
+
|
1466
|
+
@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
|
+
|
1468
|
+
### send_email(email_template_id, request) [](#method-i-send_email)
|
1469
|
+
Send an email using an email template id. You can optionally provide `requestData` to access key value pairs in the email template.
|
1470
|
+
|
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.
|
1472
|
+
|
1473
|
+
### send_family_request_email(request) [](#method-i-send_family_request_email)
|
1474
|
+
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.
|
1475
|
+
|
1476
|
+
@param request [OpenStruct, Hash] The request object that contains the parent email. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1477
|
+
|
1478
|
+
### send_passwordless_code(request) [](#method-i-send_passwordless_code)
|
1479
|
+
Send a passwordless authentication code in an email to complete login.
|
1480
|
+
|
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.
|
1482
|
+
|
1483
|
+
### send_two_factor_code(request) [](#method-i-send_two_factor_code)
|
1484
|
+
Send a Two Factor authentication code to assist in setting up Two Factor authentication or disabling.
|
1485
|
+
|
1486
|
+
@param request [OpenStruct, Hash] The request object that contains all the information used to send the code. @return [FusionAuth::ClientResponse] The ClientResponse object. @deprecated This method has been renamed to [`send_two_factor_code_for_enable_disable`](FusionAuthClient.html#method-i-send_two_factor_code_for_enable_disable), use that method instead.
|
1487
|
+
|
1488
|
+
### send_two_factor_code_for_enable_disable(request) [](#method-i-send_two_factor_code_for_enable_disable)
|
1489
|
+
Send a Two Factor authentication code to assist in setting up Two Factor authentication or disabling.
|
1490
|
+
|
1491
|
+
@param request [OpenStruct, Hash] The request object that contains all the information used to send the code. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1492
|
+
|
1493
|
+
### send_two_factor_code_for_login(two_factor_id) [](#method-i-send_two_factor_code_for_login)
|
1494
|
+
Send a Two Factor authentication code to allow the completion of Two Factor authentication.
|
1495
|
+
|
1496
|
+
@param two\_factor\_id [string] The Id returned by the Login API necessary to complete Two Factor authentication. @return [FusionAuth::ClientResponse] The ClientResponse object. @deprecated This method has been renamed to [`send_two_factor_code_for_login_using_method`](FusionAuthClient.html#method-i-send_two_factor_code_for_login_using_method), use that method instead.
|
1497
|
+
|
1498
|
+
### send_two_factor_code_for_login_using_method(two_factor_id, request) [](#method-i-send_two_factor_code_for_login_using_method)
|
1499
|
+
Send a Two Factor authentication code to allow the completion of Two Factor authentication.
|
1500
|
+
|
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.
|
1502
|
+
|
1503
|
+
### set_tenant_id(tenant_id) [](#method-i-set_tenant_id)
|
1504
|
+
### start_identity_provider_login(request) [](#method-i-start_identity_provider_login)
|
1505
|
+
Begins a login request for a 3rd party login that requires user interaction such as HYPR.
|
1506
|
+
|
1507
|
+
@param request [OpenStruct, Hash] The third-party login request that contains information from the third-party login
|
1508
|
+
|
1509
|
+
```
|
1510
|
+
providers that FusionAuth uses to reconcile the user's account.
|
1511
|
+
```
|
1512
|
+
|
1513
|
+
@return [FusionAuth::ClientResponse] The ClientResponse object.
|
1514
|
+
|
1515
|
+
### start_passwordless_login(request) [](#method-i-start_passwordless_login)
|
1516
|
+
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
|
+
|
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.
|
1519
|
+
|
1520
|
+
### start_two_factor_login(request) [](#method-i-start_two_factor_login)
|
1521
|
+
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
|
+
|
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).
|
1524
|
+
|
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.
|
1526
|
+
|
1527
|
+
### start_web_authn_login(request) [](#method-i-start_web_authn_login)
|
1528
|
+
Start a WebAuthn authentication ceremony by generating a new challenge for the user
|
1529
|
+
|
1530
|
+
@param request [OpenStruct, Hash] An object containing data necessary for starting the authentication ceremony @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1531
|
+
|
1532
|
+
### start_web_authn_registration(request) [](#method-i-start_web_authn_registration)
|
1533
|
+
Start a WebAuthn registration ceremony by generating a new challenge for the user
|
1534
|
+
|
1535
|
+
@param request [OpenStruct, Hash] An object containing data necessary for starting the registration ceremony @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1536
|
+
|
1537
|
+
### two_factor_login(request) [](#method-i-two_factor_login)
|
1538
|
+
Complete login using a 2FA challenge
|
1539
|
+
|
1540
|
+
@param request [OpenStruct, Hash] The login request that contains the user credentials used to log them in. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1541
|
+
|
1542
|
+
### update_api_key(api_key_id, request) [](#method-i-update_api_key)
|
1543
|
+
Updates an API key by given id
|
1544
|
+
|
1545
|
+
@param api\_key\_id [string] The Id of the API key to update. @param request [OpenStruct, Hash] The request object that contains all the information used to create the API Key. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1546
|
+
|
1547
|
+
### update_application(application_id, request) [](#method-i-update_application)
|
1548
|
+
Updates the application with the given Id.
|
1549
|
+
|
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.
|
1551
|
+
|
1552
|
+
### 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.
|
1554
|
+
|
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.
|
1556
|
+
|
1557
|
+
### update_connector(connector_id, request) [](#method-i-update_connector)
|
1558
|
+
Updates the connector with the given Id.
|
1559
|
+
|
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.
|
1561
|
+
|
1562
|
+
### update_consent(consent_id, request) [](#method-i-update_consent)
|
1563
|
+
Updates the consent with the given Id.
|
1564
|
+
|
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.
|
1566
|
+
|
1567
|
+
### update_email_template(email_template_id, request) [](#method-i-update_email_template)
|
1568
|
+
Updates the email template with the given Id.
|
1569
|
+
|
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.
|
1571
|
+
|
1572
|
+
### update_entity(entity_id, request) [](#method-i-update_entity)
|
1573
|
+
Updates the Entity with the given Id.
|
1574
|
+
|
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.
|
1576
|
+
|
1577
|
+
### update_entity_type(entity_type_id, request) [](#method-i-update_entity_type)
|
1578
|
+
Updates the Entity Type with the given Id.
|
1579
|
+
|
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.
|
1581
|
+
|
1582
|
+
### 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.
|
1584
|
+
|
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.
|
1586
|
+
|
1587
|
+
### update_form(form_id, request) [](#method-i-update_form)
|
1588
|
+
Updates the form with the given Id.
|
1589
|
+
|
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.
|
1591
|
+
|
1592
|
+
### update_form_field(field_id, request) [](#method-i-update_form_field)
|
1593
|
+
Updates the form field with the given Id.
|
1594
|
+
|
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.
|
1596
|
+
|
1597
|
+
### update_group(group_id, request) [](#method-i-update_group)
|
1598
|
+
Updates the group with the given Id.
|
1599
|
+
|
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.
|
1601
|
+
|
1602
|
+
### update_group_members(request) [](#method-i-update_group_members)
|
1603
|
+
Creates a member in a group.
|
1604
|
+
|
1605
|
+
@param request [OpenStruct, Hash] The request object that contains all the information used to create the group member(s). @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1606
|
+
|
1607
|
+
### update_identity_provider(identity_provider_id, request) [](#method-i-update_identity_provider)
|
1608
|
+
Updates the identity provider with the given Id.
|
1609
|
+
|
1610
|
+
@param identity\_provider\_id [string] The Id of the identity provider to update. @param request [OpenStruct, Hash] The request object that contains the updated identity provider. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1611
|
+
|
1612
|
+
### update_integrations(request) [](#method-i-update_integrations)
|
1613
|
+
Updates the available integrations.
|
1614
|
+
|
1615
|
+
@param request [OpenStruct, Hash] The request that contains all of the new integration information. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1616
|
+
|
1617
|
+
### update_ip_access_control_list(access_control_list_id, request) [](#method-i-update_ip_access_control_list)
|
1618
|
+
Updates the IP Access Control List with the given Id.
|
1619
|
+
|
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.
|
1621
|
+
|
1622
|
+
### update_key(key_id, request) [](#method-i-update_key)
|
1623
|
+
Updates the key with the given Id.
|
1624
|
+
|
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.
|
1626
|
+
|
1627
|
+
### update_lambda(lambda_id, request) [](#method-i-update_lambda)
|
1628
|
+
Updates the lambda with the given Id.
|
1629
|
+
|
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.
|
1631
|
+
|
1632
|
+
### update_message_template(message_template_id, request) [](#method-i-update_message_template)
|
1633
|
+
Updates the message template with the given Id.
|
1634
|
+
|
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.
|
1636
|
+
|
1637
|
+
### update_messenger(messenger_id, request) [](#method-i-update_messenger)
|
1638
|
+
Updates the messenger with the given Id.
|
1639
|
+
|
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.
|
1641
|
+
|
1642
|
+
### 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.
|
1644
|
+
|
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.
|
1646
|
+
|
1647
|
+
### update_system_configuration(request) [](#method-i-update_system_configuration)
|
1648
|
+
Updates the system configuration.
|
1649
|
+
|
1650
|
+
@param request [OpenStruct, Hash] The request that contains all of the new system configuration information. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1651
|
+
|
1652
|
+
### update_tenant(tenant_id, request) [](#method-i-update_tenant)
|
1653
|
+
Updates the tenant with the given Id.
|
1654
|
+
|
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.
|
1656
|
+
|
1657
|
+
### update_theme(theme_id, request) [](#method-i-update_theme)
|
1658
|
+
Updates the theme with the given Id.
|
1659
|
+
|
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.
|
1661
|
+
|
1662
|
+
### update_user(user_id, request) [](#method-i-update_user)
|
1663
|
+
Updates the user with the given Id.
|
1664
|
+
|
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.
|
1666
|
+
|
1667
|
+
### update_user_action(user_action_id, request) [](#method-i-update_user_action)
|
1668
|
+
Updates the user action with the given Id.
|
1669
|
+
|
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.
|
1671
|
+
|
1672
|
+
### update_user_action_reason(user_action_reason_id, request) [](#method-i-update_user_action_reason)
|
1673
|
+
Updates the user action reason with the given Id.
|
1674
|
+
|
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.
|
1676
|
+
|
1677
|
+
### update_user_consent(user_consent_id, request) [](#method-i-update_user_consent)
|
1678
|
+
Updates a single User consent by Id.
|
1679
|
+
|
1680
|
+
@param user\_consent\_id [string] The User Consent Id @param request [OpenStruct, Hash] The request that contains the user consent information. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1681
|
+
|
1682
|
+
### update_webhook(webhook_id, request) [](#method-i-update_webhook)
|
1683
|
+
Updates the webhook with the given Id.
|
1684
|
+
|
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.
|
1686
|
+
|
1687
|
+
### upsert_entity_grant(entity_id, request) [](#method-i-upsert_entity_grant)
|
1688
|
+
Creates or updates an Entity Grant. This is when a User/Entity is granted permissions to an Entity.
|
1689
|
+
|
1690
|
+
@param entity\_id [string] The Id of the Entity that the User/Entity is being granted access to. @param request [OpenStruct, Hash] The request object that contains all the information used to create the Entity Grant. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1691
|
+
|
1692
|
+
### validate_device(user_code, client_id) [](#method-i-validate_device)
|
1693
|
+
Validates the end-user provided user\_code from the user-interaction of the Device Authorization Grant. If you build your own activation form you should validate the user provided code prior to beginning the Authorization grant.
|
1694
|
+
|
1695
|
+
@param user\_code [string] The end-user verification code. @param client\_id [string] The client id. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1696
|
+
|
1697
|
+
### validate_jwt(encoded_jwt) [](#method-i-validate_jwt)
|
1698
|
+
Validates the provided JWT (encoded JWT string) to ensure the token is valid. A valid access token is properly signed and not expired. \<p\> This API may be used to verify the JWT as well as decode the encoded JWT into human readable identity claims.
|
1699
|
+
|
1700
|
+
@param encoded\_jwt [string] The encoded JWT (access token). @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1701
|
+
|
1702
|
+
### vend_jwt(request) [](#method-i-vend_jwt)
|
1703
|
+
It’s a JWT vending machine!
|
1704
|
+
|
1705
|
+
Issue a new access token (JWT) with the provided claims in the request. This JWT is not scoped to a tenant or user, it is a free form token that will contain what claims you provide. \<p\> The iat, exp and jti claims will be added by [`FusionAuth`](../FusionAuth.html), all other claims must be provided by the caller.
|
1706
|
+
|
1707
|
+
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
|
+
|
1709
|
+
@param request [OpenStruct, Hash] The request that contains all of the claims for this JWT. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1710
|
+
|
1711
|
+
### verify_email(verification_id) [](#method-i-verify_email)
|
1712
|
+
Confirms a email verification. The Id given is usually from an email sent to the user.
|
1713
|
+
|
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.
|
1715
|
+
|
1716
|
+
### verify_email_address(request) [](#method-i-verify_email_address)
|
1717
|
+
Confirms a user’s email address.
|
1718
|
+
|
1719
|
+
The request body will contain the verificationId. You may also be required to send a one-time use code based upon your configuration. When the tenant is configured to gate a user until their email address is verified, this procedures requires two values instead of one. The verificationId is a high entropy value and the one-time use code is a low entropy value that is easily entered in a user interactive form. The two values together are able to confirm a user’s email address and mark the user’s email address as verified.
|
1720
|
+
|
1721
|
+
@param request [OpenStruct, Hash] The request that contains the verificationId and optional one-time use code paired with the verificationId. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1722
|
+
|
1723
|
+
### verify_email_address_by_user_id(request) [](#method-i-verify_email_address_by_user_id)
|
1724
|
+
Administratively verify a user’s email address. Use this method to bypass email verification for the user.
|
1725
|
+
|
1726
|
+
The request body will contain the userId to be verified. An API key is required when sending the userId in the request body.
|
1727
|
+
|
1728
|
+
@param request [OpenStruct, Hash] The request that contains the userId to verify. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1729
|
+
|
1730
|
+
### verify_registration(verification_id) [](#method-i-verify_registration)
|
1731
|
+
Confirms an application registration. The Id given is usually from an email sent to the user.
|
1732
|
+
|
1733
|
+
@param verification\_id [string] The registration verification Id sent to the user. @return [FusionAuth::ClientResponse] The ClientResponse object. @deprecated This method has been renamed to [`verify_user_registration`](FusionAuthClient.html#method-i-verify_user_registration) and changed to take a JSON request body, use that method instead.
|
1734
|
+
|
1735
|
+
### verify_user_registration(request) [](#method-i-verify_user_registration)
|
1736
|
+
Confirms a user’s registration.
|
1737
|
+
|
1738
|
+
The request body will contain the verificationId. You may also be required to send a one-time use code based upon your configuration. When the application is configured to gate a user until their registration is verified, this procedures requires two values instead of one. The verificationId is a high entropy value and the one-time use code is a low entropy value that is easily entered in a user interactive form. The two values together are able to confirm a user’s registration and mark the user’s registration as verified.
|
1739
|
+
|
1740
|
+
@param request [OpenStruct, Hash] The request that contains the verificationId and optional one-time use code paired with the verificationId. @return [FusionAuth::ClientResponse] The ClientResponse object.
|
1741
|
+
|
1742
|
+
|