User login
POST /auth/login
Authenticates using email and password. If the user belongs to a single tenant, returns a JWT immediately. If the user has multiple tenants, returns the tenant list (no token). Provide tenant_id to select a specific tenant.
Request Body required
Section titled “Request Body required ”Request to authenticate (login).
object
User email address.
User password.
Optional tenant_id to select when user has multiple memberships.
Responses
Section titled “ Responses ”Login response
Login response - either a token (single/selected tenant) or a tenant list.
object
The JWT access token (null if tenant selection required).
Token lifetime in seconds (when access_token is present).
List of tenants the user belongs to.
Summary of a tenant the user belongs to.
object
Token type (always “Bearer” when access_token is present).
Invalid credentials
Generic error response for OpenAPI documentation.
object
Error message.
Server error