Retrieve a Lambda
This API is used to retrieve a single Lambda by unique Id or all of the Lambdas.
Request#
OpenAPI Spec
OpenAPI Spec
Request Parameters#
typeStringrequiredThe lambda type. The possible values are:
AppleReconcileAvailable since 1.17.0ClientCredentialsJWTPopulateAvailable since 1.28.0EpicGamesReconcileAvailable since 1.28.0ExternalJWTReconcileAvailable since 1.17.0FacebookReconcileAvailable since 1.17.0GoogleReconcileAvailable since 1.17.0HYPRReconcileAvailable since 1.17.0JWTPopulateLDAPConnectorReconcileAvailable since 1.18.0LinkedInReconcileAvailable since 1.23.0LoginValidationAvailable since 1.53.0MFARequirementAvailable since 1.62.0NintendoReconcileAvailable since 1.36.0OpenIDReconcileSAMLv2PopulateSAMLv2ReconcileSCIMGroupRequestConverterAvailable since 1.36.0SCIMGroupResponseConverterAvailable since 1.36.0SCIMUserRequestConverterAvailable since 1.36.0SCIMUserResponseConverterAvailable since 1.36.0SelfServiceRegistrationValidationAvailable since 1.43.0SonyPSNReconcileAvailable since 1.28.0SteamReconcileAvailable since 1.28.0TwitchReconcileAvailable since 1.28.0TwitterReconcileAvailable since 1.17.0UserInfoPopulateAvailable since 1.50.0XboxReconcileAvailable since 1.28.0
OpenAPI Spec
Request Parameters#
lambdaIdUUIDrequiredThe unique Id of the Lambda to retrieve.
Response#
The response for this API contains either a single Lambda or all of the Lambdas. When you call this API with an Id the response will contain a single Lambda. When you call this API without an Id the response will contain all of the Lambdas. Both response types are defined below along with an example JSON response.
Response Codes| Code | Description |
|---|---|
| 200 | The request was successful. The response will contain a JSON body. |
| 400 | The request was invalid and/or malformed. The response will contain an Errors JSON Object with the specific errors. This status will also be returned if a paid FusionAuth license is required and is not present. |
| 401 | You did not supply a valid Authorization header. The header was omitted or your API key was not valid. The response will be empty. See Authentication. |
| 404 | The object you requested doesn't exist. The response will be empty. |
| 500 | There was an internal error. A stack trace is provided and logged in the FusionAuth log files. The response will be empty. |
Response Body#
lambda.bodyStringThe lambda function body, a JavaScript function.
lambda.debugBooleanWhether or not debug event logging is enabled for this Lambda.
lambda.enabledBooleanDEPRECATEDThis value is not used, and may be removed in a future version.
lambda.engineTypeStringThe JavaScript execution engine for the lambda. The possible values are:
GraalJSNashornDeprecated since 1.35.0, Removed in 1.49.0
lambda.idUUIDThe Id of the Lambda.
lambda.insertInstantLongThe instant that the lambda created.
lambda.lastUpdateInstantLongThe instant that the lambda was last updated.
lambda.nameStringThe name of the lambda.
lambda.typeStringThe lambda type. The possible values are:
AppleReconcileClientCredentialsJWTPopulateEpicGamesReconcileExternalJWTReconcileFacebookReconcileGoogleReconcileHYPRReconcileJWTPopulateLDAPConnectorReconcileLinkedInReconcileLoginValidationMFARequirementNintendoReconcileOpenIDReconcileSAMLv2PopulateSAMLv2ReconcileSCIMGroupRequestConverterSCIMGroupResponseConverterSCIMUserRequestConverterSCIMUserResponseConverterSelfServiceRegistrationValidationSonyPSNReconcileSteamReconcileTwitchReconcileTwitterReconcileUserInfoPopulateXboxReconcile
Example Response JSON
{
"lambda": {
"id": "7e66bac3-fa41-47fb-b8fd-12b35b5e1807",
"body": "function reconcile(user, registration, samlResponse) { registration.roles = samlResponse.assertion.attributes['roles'] || [];}",
"name": "Name",
"debug": false,
"enabled": true,
"engineType": "GraalJS",
"insertInstant": 1572469040579,
"lastUpdateInstant": 1595361143101,
"type": "SAMLv2Reconcile"
}
}Response Body#
lambdasArrayThe list of Lambda objects.
lambdas[x].bodyStringThe lambda function body, a JavaScript function.
lambdas[x].debugBooleanWhether or not debug event logging is enabled for this Lambda.
lambdas[x].enabledBooleanDEPRECATEDThis value is not used, and may be removed in a future version.
lambdas[x].engineTypeStringThe JavaScript execution engine for the lambda. The possible values are:
GraalJSNashornDeprecated since 1.35.0, Removed in 1.49.0
lambdas[x].idUUIDThe Id of the Lambda.
lambdas[x].insertInstantLongThe instant that the lambda created.
lambdas[x].lastUpdateInstantLongThe instant that the lambda was last updated.
lambdas[x].nameStringThe name of the lambda.
lambdas[x].typeStringThe lambda type. The possible values are:
AppleReconcileClientCredentialsJWTPopulateEpicGamesReconcileExternalJWTReconcileFacebookReconcileGoogleReconcileHYPRReconcileJWTPopulateLDAPConnectorReconcileLinkedInReconcileLoginValidationMFARequirementNintendoReconcileOpenIDReconcileSAMLv2PopulateSAMLv2ReconcileSCIMGroupRequestConverterSCIMGroupResponseConverterSCIMUserRequestConverterSCIMUserResponseConverterSelfServiceRegistrationValidationSonyPSNReconcileSteamReconcileTwitchReconcileTwitterReconcileUserInfoPopulateXboxReconcile
Example Response JSON for Lambda Search
{
"lambdas": [
{
"id": "7e66bac3-fa41-47fb-b8fd-12b35b5e1807",
"body": "function reconcile(user, registration, samlResponse) { registration.roles = samlResponse.assertion.attributes['roles'] || [];}",
"name": "SAML Reconcile",
"debug": false,
"enabled": true,
"engineType": "GraalJS",
"insertInstant": 1572469040579,
"lastUpdateInstant": 1595361143101,
"type": "SAMLv2Reconcile"
}
],
"total": 1
}Example Response JSON
{
"lambdas": [
{
"id": "7e66bac3-fa41-47fb-b8fd-12b35b5e1807",
"body": "function reconcile(user, registration, samlResponse) { registration.roles = samlResponse.assertion.attributes['roles'] || [];}",
"name": "Name",
"debug": false,
"enabled": true,
"engineType": "GraalJS",
"insertInstant": 1572469040579,
"lastUpdateInstant": 1595361143101,
"type": "SAMLv2Reconcile"
}
]
}