Identra Docs
Reference / Auth

Begin a passkey sign-in (primary). Publishable.

POST /v1/auth/passkeys/authenticate/begin
End-user session operationId: passkey_authenticate_begin

Authorization

Called from the browser with the publishable application id (x-application-id); the access token lives in memory.

Request body · required

  • email string

    Optional username to scope the assertion; omit for a discoverable (usernameless) passkey.

  • origin string required

Responses

200 Assertion options
{
  "data": {
    "options": {},
    "state": "string"
  },
  "error": {
    "code": "string",
    "message": "string"
  },
  "meta": {
    "timestamp": "string"
  },
  "success": false
}

Request

curl -X POST "http://localhost:8080/v1/auth/passkeys/authenticate/begin" \
  -H "Content-Type: application/json" \
  -d '{
  "email": "string",
  "origin": "string"
}'

Try it

live request
POST http://localhost:8080/v1/auth/passkeys/authenticate/begin

Request body

application/json