Complete Verification Flow with Link Method
Use this endpoint to complete a verification flow using the link method. This endpoint behaves differently for API and browser flows and has several states:
choose_method expects flow (in the URL query) and email (in the body) to be sent and works with API- and Browser-initiated flows. For API clients it either returns a HTTP 200 OK when the form is valid and HTTP 400 OK when the form is invalid and a HTTP 302 Found redirect with a fresh verification flow if the flow was otherwise invalid (e.g. expired). For Browser clients it returns a HTTP 302 Found redirect to the Verification UI URL with the Verification Flow ID appended. sent_email is the success state after choose_method and allows the user to request another verification email. It works for both API and Browser-initiated flows and returns the same responses as the flow in choose_method state. passed_challenge expects a token to be sent in the URL query and given the nature of the flow ("sending a verification link") does not have any API capabilities. The server responds with a HTTP 302 Found redirect either to the Settings UI URL (if the link was valid) and instructs the user to update their password, or a redirect to the Verification UI URL with a new Verification Flow ID which contains an error message that the verification link was invalid.
More information can be found at Ory Kratos Email and Phone Verification Documentation.
Request
- Base URLhttps://demo.tenants.oryapis.com/api/kratos/public
- URLhttps://demo.tenants.oryapis.com/api/kratos/public/self-service/verification/methods/link
- Authnone declared
Query parameters
Verification Token
The verification token which completes the verification request. If the token is invalid (e.g. expired) an error will be shown to the end-user.
The Flow ID
format: uuid
Request body
Changes
No recorded changes to this operation across all 4 revisions of this API.