Register
Authentication
Register
POST
Register
Create a new user account with email and password.
Response:
Response:
Body
string
required
User’s email address
string
required
User’s password (minimum 8 characters, must contain uppercase, lowercase, and digit)
string
User’s full name (optional) - Used for personalized greetings and profile display
Headers
The role is determined server-side based on request headers:string
Platform operator key - Required for developer registration
string
Developer API key - Required for end_user registration
string
Project UUID - Required when registering end users with developer key
The system automatically determines the user role from headers:
X-Operator-Keypresent → Creates developer accountX-Developer-Key+X-Project-IDpresent → Creates end_user account in specified project- No special headers → Registration rejected (public registration disabled)
Response
string
Unique user identifier (UUID)
string
User’s email address
string
User’s full name (null if not provided)
string
User’s role:
platform_operator, developer, or end_userboolean
Account activation status (false by default, requires email verification)
string
Account creation timestamp (ISO 8601)
string
Project UUID (only present for end_user accounts)
object
One-time provisioning data for developers (only returned for developer registration)
string
JWT access token (optional, returned for end_user registration for immediate authentication)
string
JWT refresh token (optional, returned for end_user registration)
string
Token type, typically “bearer” (optional)
Example Requests
Register End User
Register Developer
Password Requirements
Passwords must meet the following criteria:- Minimum 8 characters
- At least one uppercase letter (A-Z)
- At least one lowercase letter (a-z)
- At least one digit (0-9)
Password123, SecurePass456, MyP@ssw0rd
Email Uniqueness
Email uniqueness rules vary by role:- End Users: Email must be unique within the project (same email can exist in different projects)
- Developers/Operators: Email must be globally unique
Related Pages
Login
Authenticate existing users
Verify Email
Complete email verification
Developer Keys
Manage developer API keys
Cloud Admin Registration
Register via web interface
Starter Kit Auth
Implement registration in your app
Quick Start
Complete registration tutorial
Body
application/json
Response
Successful Response
Enhanced registration response with role and provisioning data
Provisioning data for developers (one-time response)

