Olympus Docs
ReferenceAPIsOry Identities APIfrontend

Create Recovery Flow for Browsers

This endpoint initializes a browser-based account recovery flow. Once initialized, the browser will be redirected to

GET /self-service/recovery/browser

This endpoint initializes a browser-based account recovery flow. Once initialized, the browser will be redirected to selfservice.flows.recovery.ui_url with the flow ID set as the query parameter ?flow=. If a valid user session exists, the browser is returned to the configured return URL.

If this endpoint is called via an AJAX request, the response contains the recovery flow without any redirects or a 400 bad request error if the user is already authenticated.

This endpoint is NOT INTENDED for clients that do not have a browser (Chrome, Firefox, ...) as cookies are needed.

More information can be found at Ory Kratos Account Recovery Documentation.

Operation ID: createBrowserRecoveryFlow    Tag: frontend

Query parameters

NameTypeRequiredDescription
return_tostringnoThe URL to return the browser to after the flow was completed.
skip_settingsstringnoSkip redirection to the settings UI after the recovery flow was completed. Instead, the user will be redirected to the URL specified in return_to query parameter or the default return URL if return_to is not set.

Responses

StatusDescriptionBody
200recoveryFlowapplication/json, object
303Empty responses are sent when, for example, resources are deleted. The HTTP status code for empty responses is typically 204.-
400errorGenericapplication/json, object
defaulterrorGenericapplication/json, object

Generated from /tmp/kratos-api.json at build time.

On this page