---
title: "Start Passkey Registration"
method: POST
path: "/{tenant_id}/registration/initialize"
tags: ["credentials"]
---

# Start Passkey Registration

`POST /{tenant_id}/registration/initialize`

Initialize a registration for webauthn credentials

## Path parameters

- `tenant_id` string, uuid, required

## Headers

- `apiKey` string, required

## Request body

- object
  - `user_id` string, required
  - `username` string, required
  - `icon` string
  - `display_name` string

## Response `200`

Example response

- object
  - `publicKey` object, required
    - `rp` RelyingPartyEntity, required
      - `id` string
      - `name` string, required
    - `user` PublicKeyUser, required
      - `id` string, required
      - `displayName` string, required
      - `name` string, required
    - `challenge` string, required
    - `pubKeyCredParams` CredentialParameterEntity[], required
      - `type` 'public-key', required
      - `alg` integer, required
    - `timeout` integer
    - `excludeCredentials` CredentialDescriptorEntity[]
      - `type` 'public-key', required
      - `id` string, required
      - `transports` string[]
    - `authenticatorSelection` AuthenticationSelectionEntity
      - `authenticatorAttachement` 'cross-platform' | 'platform'
      - `requireResidentKey` boolean
      - `residentKey` 'discouraged' | 'preferred' | 'required'
      - `userVerification` 'discouraged' | 'preferred' | 'required'
    - `attestation` 'direct' | 'enterprise' | 'indirect' | 'none'
    - `extensions` object
      - `appid` string
      - `appidExclude` string
      - `credProps` boolean

## Other responses

- `400` — Error Response with detailed information
- `401` — Error Response with detailed information
- `500` — Error Response with detailed information

---

[API](https://skmtc.dev/hanko/apis/hanko-admin-api.md) · [All operations](https://skmtc.dev/hanko/apis/hanko-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hanko/hanko-admin-api/revisions/d22a127b0978/schema)