Authenticate with a directory password and create a managed browser session.
POST
/api/auth/directory-password/login
Code sample: Shell / cURL
curl --request POST \ --url https://auth.example.com/api/auth/directory-password/login \ --header 'Content-Type: application/json' \ --data '{ "username": "alice", "password": "correct-horse-battery-staple", "invite_token": "invite-token-if-admin-invitation-fallback-is-required" }'Request Body required
Section titled “Request Body required ” Media type application/json
object
username
required
string
password
required
string format: password
invite_token
Optional tenant invitation token used only to authorize admin-invitation-only migration fallback.
string
authorization_challenge_id
string
human_verification_response
string
key
additional properties
Example
{ "username": "alice", "password": "correct-horse-battery-staple", "invite_token": "invite-token-if-admin-invitation-fallback-is-required"}Responses
Section titled “ Responses ”Successful JSON response.
Media type application/json
One of:
object
ok
required
boolean
expires_in
required
integer
session
required
object
userId
string
createdAt
integer
expiresAt
integer
authTime
integer
acr
string
amr
Array<string>
key
additional properties
authorization
object
key
additional properties
redirect_url
string format: uri
object
ok
required
boolean
migration
required
object
required
required
boolean
action
required
string
transaction_id
required
string
transaction_token
required
string
expires_at
required
integer
campaign_id
required
string
state
required
string
email_code_fallback_mode
required
string
email_code_fallback_available
required
boolean
email_code_fallback
key
additional properties
user
required
key
additional properties
object
ok
required
boolean
recovery
required
object
required
required
boolean
reason
required
string
transaction_id
required
string
transaction_token
required
string
expires_at
required
integer
masked_email
required
string
key
additional properties
user
required
key
additional properties
Example
{ "ok": true, "expires_in": 86400, "session": { "userId": "user_123", "createdAt": 1770000000000, "expiresAt": 1770086400000, "authTime": 1770000000, "acr": "urn:mace:incommon:iap:bronze", "amr": [ "pwd", "directory" ] }, "user": { "id": "user_123", "name": "Example User" }}