Auth

ChangePassword

POST/api/v1/auth/change-password

ChangePassword handles password changes (useful for temp passwords)

Responses

CodeDescription
200OK
400Bad Request
401Unauthorized
500Internal Server Error

EnsureCloudUser

POST/api/v1/auth/ensure-cloud-user

EnsureCloudUser 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

CodeDescription
400Bad Request
401Unauthorized
403Forbidden
500Internal Server Error

Login

POST/api/v1/auth/login

Login handles user authentication with email/password

Responses

CodeDescription
200OK
400Bad Request
401Unauthorized
500Internal Server Error

Logout

POST/api/v1/auth/logout

Logout handles user logout (revokes tokens)

Responses

CodeDescription
200OK
400Bad Request
401Unauthorized
500Internal Server Error

Me

GET/api/v1/auth/me

Me returns information about the currently authenticated user

Responses

CodeDescription
401Unauthorized
500Internal Server Error

Onboard

POST/api/v1/auth/onboard

Onboard 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

CodeDescription
400Bad Request
401Unauthorized
500Internal Server Error

RefreshToken

POST/api/v1/auth/refresh

RefreshToken handles token refresh using a valid refresh token

Responses

CodeDescription
200OK
400Bad Request
401Unauthorized

SetupAdmin

POST/api/v1/auth/setup

SetupAdmin handles initial admin user setup (replaces legacy password system)

Responses

CodeDescription
400Bad Request
500Internal Server Error

CheckSetupStatus

GET/api/v1/auth/setup-status

CheckSetupStatus checks if initial setup is needed

Responses

CodeDescription
500Internal Server Error