Skip to main content

Register

POST 

/auth/register

Register a new account and send a verification email (SCRIFT-79).

Creates the user + a free-tier API key + a 24h verification token, then schedules the verification email via BackgroundTasks and returns 202 {"message": "Check your email to verify your account."}.

Tokens are NOT issued here - only GET /auth/verify can exchange a valid magic-link token for an access / refresh pair and a raw API key.

Rate limit (#223): 5/hour per client address, because every call may send a verification email. Per target address it is already one: an address can be registered once, and a second register is a 409 that sends nothing.

Request​

Responses​

Successful Response