Sign in

v1

latestOpenAPI 3.0.02026-07-2464438356.8 KB
Approvers

Initiate an end-user custodial challenge for an approver

Initiates an email challenge to validate the action of an approver. This endpoint should only be used in end-user custodial payout flows.

post/api/approvers/end-user-custodial/initiate-challenge

Headers

on-behalf-ofstring required

Organization ID to act on behalf of

Request body

approverIdstring required

Identifier of the Approver who should receive the email challenge

publicKeystring required

The public key to associate with the email authentication. You can get this from the EndUserCustodialSDK.getPublicKey() method.

Example request

{
  "approverId": "user123",
  "publicKey": "04a82bfb0edb13d..."
}

Response

Challenge initiated successfully

authenticatorIdstring required

The id needed to create an EndUserCustodialSDK session

Example response

{
  "authenticatorId": "auth_1234567890abcdef"
}