Identity Service

Back

Custom Sign In API

Version: v1

Login

Check the username/password of a user

POST/api/account/login

Example Request

{
   "username": "[email protected]",
   "password": "",
   "persistent": false,
   "rememberUserName": true,
   "tenant": "my-tenant",
   "clientId": "my-app-id"
}

Parameters

NameDescription

username* required

string

(body)

password* required

string

(body)

persistent

boolean

(body)

rememberUserName

boolean

(body)

tenant

string

(body)

acrValues

string

(body)

clientId* required

string

(body)

authRequest

(body)

cookiesEnabled

boolean

(body)

Responses

200

If the request was successful. May not indicate the user was signed in completely

{
   "sessionToken": null,
   "stateToken": null,
   "next": "done",
   "principal": ,
   "items": null
}
NameTypeDescriptionFormat
sessionTokenstring
stateTokenstring
nextstring
principal
itemsobject
400

If the username or password was incorrect. Or some other user-facing error occurred

{
   "type": null,
   "identifier": "",
   "message": null,
   "responseCode": null,
   "errors": null
}
NameTypeDescriptionFormat
typestring
identifierstringuuid
messagestring
responseCodestring
errorsarray
401

If the user is not allowed to sign in currently

403

Forbidden

{
   "type": null,
   "identifier": "",
   "message": null,
   "responseCode": null,
   "errors": null
}
NameTypeDescriptionFormat
typestring
identifierstringuuid
messagestring
responseCodestring
errorsarray

GET/api/account/login-resume

Parameters

NameDescription

token

string

(query)

Responses

200

Success

POST/api/account/login-persist

Example Request

Parameters

NameDescription

stateToken

string

(body)

persistent

boolean

(body)

rememberKeepMeSignIn

boolean

(body)

Responses

200

Success

NoAccessRedirect

GET/no-access-callback

Parameters

NameDescription

state

string

(query)

Responses

200

Success

OpDashboard

GET/_/op-dashboard

Parameters

NameDescription

Responses

200

Success

ProfileRedirect

GET/profile

Parameters

NameDescription

state

string

(query)

Responses

200

Success

ResetPassword

POST/api/account/update-expired-password

Example Request

{
   "password": "",
   "stateToken": "",
   "clientId": "",
   "tenant": ""
}

Parameters

NameDescription

password* required

string

(body)

stateToken* required

string

(body)

clientId* required

string

(body)

tenant* required

string

(body)

Responses

200

Success