Skip to content
Darwin Evolution

Login with email + password

POST
/api/v2/auth/login

Returns a JWT access token. tenantId is optional; if omitted and the user belongs to multiple tenants, the returned token is partial. Call /select-tenant before tenant-scoped APIs.

Request Body required

Section titled “Request Body required ”
object
email
required
string format: email
Example
operator@example.com
password
required
string format: password
>= 8 characters
tenantId

Optional. If user has multiple memberships and tenantId is omitted, the response is a partial token.

string

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Authenticated

object
accessToken
string
refreshToken
string
partial

True when the token is tenant-less and /select-tenant is required next.

boolean
stale

True when membership data has changed and re-authentication is recommended.

boolean

401

Section titled “401 ”

Authentication required or invalid

object
error
string
Example
unauthorized
message
string