Skip to main content
POST
/
Agent
/
Account
/
RemoteQuickLogin
Remote Quick Login
curl --request POST \
  --url https://{host}/Agent/Account/RemoteQuickLogin \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "legalId": "<string>",
  "purpose": "<string>"
}
'
{
  "loggedIn": true,
  "petitionSent": true
}

​
Overview

Allows the client to trigger a Quick Login procedure on a remote Neuron, without having to scan a QR code, and if successful, logging in on the machine using a given Legal Identity. Note: The call to the remote neuron does not require a login or an Agent API connection. Note 2: A Legal ID can be used to login on multiple machines. If administrative access is granted to the corresponding Legal Identity, an administrative login will also be performed, if the login is successful. Note 3: Only session logins (i.e. admin logins and quick-logins) can be made using this resource. No new JWT token will be generated, as the Agent API can only be connected to the broker associated with the account the agent is using. Note 4: You can prepare the the remote quick login procedure by calling the /Account/PrepareRemoteQuickLogin resource to get the Legal ID associated with the current account. Note 5: This method of initiating the Quick-Login does not require the client to scan a QR code. Instead, the request to sign the login is sent automatically to the client when the /Account/RemoteQuickLogin resource is called. If authentication succeeds, a quick-login is performed automatically in the current session, and if there is an administrative account associated with the digital identity, such a login is also performed in the current session.

​
Authentication

Requires a valid JWT bearer token.

​
Notes

This endpoint uses the request schema notation described in Pattern matching.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
legalId
string
required
​
purpose
string
required

Response

200 - application/json

Success

​
loggedIn
boolean
required
​
petitionSent
boolean
required