v1

latestOpenAPI 3.0.3AGPL-3.0-or-later2026-07-2687268192.4 KB
Passcode

Initialize passcode login

Initialize a passcode login for the user identified by user_id. Sends an email containing the actual passcode to the user's primary email address or to the address specified through email_id. Returns a representation of the passcode.

post/passcode/login/initialize

Request body

user_idstring uuid4 required
email_idstring uuid4

Example request

{
  "user_id": "c339547d-e17d-4ba7-8a1d-b3d5a4d17c1c",
  "email_id": "c339547d-e17d-4ba7-8a1d-b3d5a4d17c1c"
}

Response

Successful passcode login initialization

idstring uuid4
ttlinteger

Lifespan of a passcode in seconds

created_atstring date-time

Time of creation of the passcode

Example response

{
  "id": "c339547d-e17d-4ba7-8a1d-b3d5a4d17c1c",
  "ttl": 300
}