Skip to main content

Create a WebAuthN registration link

POST 
/resources/v3alpha/users/:id/webauthn/registration_link

Create a link, which includes a code, that can either be returned or directly sent to the user. The code will allow the user to start a new WebAuthN registration.

Request​

Path Parameters

    id stringrequired

    unique identifier of the user.

Body

required

    instance

    object

    id string
    domain string

    organization

    object

    Optionally expect the user to be in this organization.

    orgId string
    orgDomain string

    sendLink

    object

    Let ZITADEL send the link to the user via email.

    urlTemplate string

    Possible values: non-empty and <= 200 characters

    Optionally set a url_template, which will be used in the mail sent by ZITADEL to guide the user to your passkey registration page. If no template is set, the default ZITADEL url will be used.

    returnCode object

    Get the code back to provide it to the user in your preferred mechanism.

Responses​

WebAuthN registration successfully created

Schema

    details

    object

    id string
    created date-time

    the timestamp of the first event applied to the object.

    changed date-time

    the timestamp of the last event applied to the object.

    owner

    object

    the parent object representing the returned objects context.

    type string

    Possible values: [OWNER_TYPE_UNSPECIFIED, OWNER_TYPE_SYSTEM, OWNER_TYPE_INSTANCE, OWNER_TYPE_ORG]

    Default value: OWNER_TYPE_UNSPECIFIED

    id string

    code

    object

    In case the medium was set to return_code, the code will be returned.

    id stringrequired

    Possible values: non-empty and <= 200 characters

    ID to the one time code generated by ZITADEL.

    code stringrequired

    Possible values: non-empty and <= 200 characters

    one time code generated by ZITADEL.

Loading...