Finish passkey registration

POST

/user/authn

Auth: JWT Required

Request

Authorization

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Body Params application/json

response

string

required

JSON encoded CredentialCreationResponse with additional fields, see example for details.

string

required

Name of the passkey. Available placeholders:

{os}: OS name parsed from ua;

{browser}: Browser name parsed from ua;

string

required

Client user agent.

Example

{
    "response": "{\"id\":\"7urNE_WTQSGqA06D0w-1Xw\",\"type\":\"public-key\",\"rawId\":\"7urNE_WTQSGqA06D0w-1Xw\",\"response\":{\"attestationObject\":\"o2NmbXRkbm9uZWdhdHRTdG10oGhhdXRoRGF0YViUSZYN5YgOjGh0NBcPZHZgW4_krrmihjLHmVzzuoMdl2NdAAAAANVIgm55tNtAo9gREW9-g0kAEO7qzRP1k0EhqgNOg9MPtV-lAQIDJiABIVggg1lGbgriP72Ro5GpDhgyH_FwmxDFbg_9IAvb1kKqtuUiWCA-wxwgCMp5OVE0s0E8U7ZR-v9HcVr88onxRbauZDUD9A\",\"clientDataJSON\":\"eyJ0eXBlIjoid2ViYXV0aG4uY3JlYXRlIiwiY2hhbGxlbmdlIjoiZnlFQ2I2aDh0bXZRcnZUV1p2Y05RZ0VUb08zMExqRHRmNzIxeUlHVTA0RSIsIm9yaWdpbiI6Imh0dHA6Ly9sb2NhbGhvc3Q6NTE3MyIsImNyb3NzT3JpZ2luIjpmYWxzZX0\"}}",
    "name": "{browser} on {os}",
    "ua": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/137.0.0.0 Safari/537.36"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/user/authn' \
--header 'Content-Type: application/json' \
--data-raw '{
    "response": "{\"id\":\"7urNE_WTQSGqA06D0w-1Xw\",\"type\":\"public-key\",\"rawId\":\"7urNE_WTQSGqA06D0w-1Xw\",\"response\":{\"attestationObject\":\"o2NmbXRkbm9uZWdhdHRTdG10oGhhdXRoRGF0YViUSZYN5YgOjGh0NBcPZHZgW4_krrmihjLHmVzzuoMdl2NdAAAAANVIgm55tNtAo9gREW9-g0kAEO7qzRP1k0EhqgNOg9MPtV-lAQIDJiABIVggg1lGbgriP72Ro5GpDhgyH_FwmxDFbg_9IAvb1kKqtuUiWCA-wxwgCMp5OVE0s0E8U7ZR-v9HcVr88onxRbauZDUD9A\",\"clientDataJSON\":\"eyJ0eXBlIjoid2ViYXV0aG4uY3JlYXRlIiwiY2hhbGxlbmdlIjoiZnlFQ2I2aDh0bXZRcnZUV1p2Y05RZ0VUb08zMExqRHRmNzIxeUlHVTA0RSIsIm9yaWdpbiI6Imh0dHA6Ly9sb2NhbGhvc3Q6NTE3MyIsImNyb3NzT3JpZ2luIjpmYWxzZX0\"}}",
    "name": "{browser} on {os}",
    "ua": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/137.0.0.0 Safari/537.36"
}'

Responses

🟢200Success

application/json

Body

data

object (Passkey)

required

Response content. In some error type, e.g. lock conflicting errors, this field wil present details of the error, e.g. who is locking the current file.

string

required

ID of the passkey.

Example:

7urNE/WTQSGqA06D0w+1Xw==

name

string

required

Name of the passkey platform.

Example:

Chrome on Mac OS X

used_at

string <date-time> | null

optional

Datetime when the passkey is lastly used.

Example:

2025-06-13T10:43:09.929001+08:00

created_at

string <date-time>

required

Datetime when the passkey is created.

Example:

2025-06-13T10:43:09.929001+08:00

code

integer

required

Response code.
0 - Success.

Default:

Example:

msg

string

optional

Human readable error message (if any).

error

string | null

optional

Internal error message, only visable in debug mode.

correlation_id

string <uuid> | null

optional

Correlation ID of the request. Only presented on failed reqeust.

Example:

b4351ecc-ee1a-4455-bc94-2c3dbcc58538

Example

{
    "code": 0,
    "data": {
        "id": "7urNE/WTQSGqA06D0w+1Xw==",
        "name": "Chrome on Mac OS X",
        "created_at": "2025-06-13T10:43:09.929001+08:00"
    },
    "msg": ""
}

Modified at 2025-06-27 03:07:53

Prepare passkey registration

Delete passkey