Client Actions

Download OpenAPI specification:Download

This backend API is used to report client actions and add the user context, allowing detection and response reporting and user profiling.

Trigger action event

Report a client action event that occurs in an SDK session

SecurityHTTP: risk_access_token
Request
Request Body schema: application/json
required
session_token
required
string

A token returned by the SDK for the session established upon SDK initialization.

action_type
required
string

The action type

user_id
string

Opaque identifier of the authenticated user in your system.

claimed_user_id
string

User ID of the not yet authenticated user, used to enhance risk and trust assessments. Once the user is authenticated, setAuthenticatedUser should be called.

correlation_id
string

Any ID that could help relate the action with external context or session

object

Transaction data-points given in the relevant action

Responses
201

Trigger action has been received and stored successfully.

400

Bad request

401

Invalid authentication

403

Invalid authorization

429

Rate limit reached

500

Internal error

post/action/trigger-action
Request samples
application/json
{
  • "session_token": "string",
  • "action_type": "transaction",
  • "user_id": "string",
  • "claimed_user_id": "string",
  • "correlation_id": "string",
  • "transaction_data": {
    }
}
Response samples
application/json
{
  • "action_token": "string"
}

Set authenticated user

Sets the user context for a client action reported to the SDK. It should be set only after you’ve fully authenticated the user (including, for example, any 2FA that was required).

SecurityHTTP: risk_access_token
Request
Request Body schema: application/json
required
user_id
required
string

Opaque identifier of the user in your system.

action_token
required
string

The token return by the SDK when the action was reported.

Responses
201

User Auth has been received and stored successfully.

400

Bad request

401

Invalid authentication

403

Invalid authorization

429

Rate limit reached

500

Internal error

post/action/authenticated-user
Request samples
application/json
{
  • "user_id": "string",
  • "action_token": "string"
}