Register New User

post/v1/auth/register

Part of Auth.

Creates the user and a personal organization. CAPTCHA required in production. Sends verification email when email verification is enabled.

Authentication

This operation does not require an API key.

Request body

Required, application/json.

Field	Type	Description
`name`required	string	User's display name
`email`required	string (email)	User's email address
`password`required	string	User's password (must meet security requirements)
`captcha_token`optional	string	CAPTCHA verification token (required in production)
`invite_token`optional	string	Org invitation token from an invitation email. When present, the new user joins the inviting organization at the invited role instead of receiving a personal organization.

Example request

curl

curl -X POST "https://api.robosystems.ai/v1/auth/register" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "string",
  "email": "user@example.com",
  "password": "string"
}'

Responses

201 Successful Response

Field	Type	Description
`user`required	object	User information
`org`optional	object	Organization information (personal org created automatically on registration)
`message`required	string	Success message
`status`optional	string	Login flow state: authenticated (token present), or a passkey MFA step is required before a session is issued (mfa_token present) One of: `authenticated`, `mfa_required`, `mfa_enrollment_required` Default: `authenticated`
`mfa_token`optional	string	Short-lived token authorizing the MFA second step or forced enrollment; present only when status is not 'authenticated'
`token`optional	string	JWT authentication token (optional for cookie-based auth)
`expires_in`optional	integer	Token expiry time in seconds from now
`refresh_threshold`optional	integer	Recommended refresh threshold in seconds before expiry

Status	Meaning
400	Invalid request
409	Email already registered
422	Validation Error
429	Rate limit exceeded
500	Internal server error
503	Registration temporarily disabled