Skip to main content
POST
Invite a person

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
email
string
required
Required string length: 3 - 320
password
string
required

At least 12 characters.

Required string length: 12 - 1024
roles
BindingIn · object[]
required
Required array length: 1 - 32 elements
with_totp
boolean
default:true

Create a TOTP secret and return its enrollment URI once.

Response

The person, with the enrollment URI when a second factor was requested.

active
boolean
required
email
string
required
roles
BindingOut · object[]
required
user_id
string<uuid>
required
last_login_at
string<date-time> | null
totp_uri
string | null

Shown once, at creation, for enrollment.