General APIs with JWT

Fingerprint Signup

Create an account with no email or password and mint the fingerprint that logs into it.

Fully headless signup, meant for agents and scripts: no email, no password, no verification step, nothing that needs a human. Send an empty body: username is only a display name, it is not part of the login, and asking for a taken one fails with 409.

When the response carries a non-null api_key, it works immediately as the X-API-Key header. Key minting is best-effort, so signup still succeeds when api_key is null. Renting also requires a balance sufficient to cover the minimum rental window; signup credit is conditional.

Despite the name, the fingerprint is not WebAuthn, a passkey or biometrics — it is a random 32-character string. It is returned exactly once, it is the login for the lium.io dashboard, and it is the only way back into an account that has no email, so the caller must store it.

post/auth/signup

Request body

referral_codestring nullable

custom_referral_codestring nullable

usernamestring nullable

Response

Successful Response

user_idstring uuid required

usernamestring required

fingerprintstring required

Account credential: a random 32-character string, not a passkey or biometrics. Shown once — it is the dashboard login and the only way to recover the account, so store it.

api_keystring nullable

API key for the new account. When present, it is usable right away as the X-API-Key header. Null if minting it failed.

signup_credit_grantedboolean

Whether the one-time signup credit landed. It is granted only when ENABLE_FREE_CREDIT is enabled and no other account has claimed it from the client IP.

Changes

No recorded changes to this endpoint across all 1 revision of this API.