onboarding

Verify Account Registration

Verify the emailed 6-digit code (challenge_id, code) and create the 4chems account. Never guess or retry codes, and never ask the user for a password.

Anonymous. On a matching code, creates the user (email already verified) and Keycloak mails a link where the user sets their own password; no password passes through this API or the agent. Then call start_device_login to sign in. Answers 409 registration.exists when the address already has an account, and 503 registration.idp_unavailable on a Keycloak failure — retry with the same challenge_id and code.

post/v1/onboarding/registrations/account/verify

Request

  • Base URL: https://api.4chems.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.4chems.com/v1/onboarding/registrations/account/verify
  • Auth: none required

Request body

challenge_idstring uuid required
codestring required

Response

Successful Response

account'created' required
next_stepstring required

Changes

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