Interlaken
API referenceIdentity and accessAuthentication

Exchange credentials for an OAuth 2.0 token, or open a second-factor challenge

POST
/api/v1/auth/login

Returns the token response when the browser presents a live trusted-device cookie; otherwise returns an MFAChallengeResponse (status "mfa_required") to complete via /auth/mfa/verify.

Authorization

AuthorizationBearer <token>

An access token from this zone's POST /oauth/token, or a session token from POST /api/v1/auth/login. Send it as Authorization: Bearer <token>.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/v1/auth/login" \  -H "Content-Type: application/json" \  -d '{    "email": "string",    "password": "string"  }'
{  "access_token": "string",  "expires_in": 0,  "id_token": "string",  "refresh_token": "string",  "scope": "string",  "token_type": "string"}