Auth
ChangePassword
/api/v1/auth/change-passwordChangePassword handles password changes (useful for temp passwords)
Responses
| Code | Description |
|---|---|
| 200 | OK |
| 400 | Bad Request |
| 401 | Unauthorized |
| 500 | Internal Server Error |
EnsureCloudUser
/api/v1/auth/ensure-cloud-userEnsureCloudUser ensures that a user and a personal organization exist, assigning super_admin role. Idempotent: if user/org/role mapping already exist, it returns success without changes.
Responses
| Code | Description |
|---|---|
| 400 | Bad Request |
| 401 | Unauthorized |
| 403 | Forbidden |
| 500 | Internal Server Error |
Login
/api/v1/auth/loginLogin handles user authentication with email/password
Responses
| Code | Description |
|---|---|
| 200 | OK |
| 400 | Bad Request |
| 401 | Unauthorized |
| 500 | Internal Server Error |
Logout
/api/v1/auth/logoutLogout handles user logout (revokes tokens)
Responses
| Code | Description |
|---|---|
| 200 | OK |
| 400 | Bad Request |
| 401 | Unauthorized |
| 500 | Internal Server Error |
Me
/api/v1/auth/meMe returns information about the currently authenticated user
Responses
| Code | Description |
|---|---|
| 401 | Unauthorized |
| 500 | Internal Server Error |
Onboard
/api/v1/auth/onboardOnboard performs the user onboarding flow by validating an onboarding API key, revoking it, generating a new persistent API key, minting session tokens, and returning the details to the client.
Responses
| Code | Description |
|---|---|
| 400 | Bad Request |
| 401 | Unauthorized |
| 500 | Internal Server Error |
RefreshToken
/api/v1/auth/refreshRefreshToken handles token refresh using a valid refresh token
Responses
| Code | Description |
|---|---|
| 200 | OK |
| 400 | Bad Request |
| 401 | Unauthorized |
SetupAdmin
/api/v1/auth/setupSetupAdmin handles initial admin user setup (replaces legacy password system)
Responses
| Code | Description |
|---|---|
| 400 | Bad Request |
| 500 | Internal Server Error |
CheckSetupStatus
/api/v1/auth/setup-statusCheckSetupStatus checks if initial setup is needed
Responses
| Code | Description |
|---|---|
| 500 | Internal Server Error |