Approve a request

Permissions required: Propose and Accept settlements

Approve a request that is waiting on you. The signed request body is recorded as your approval, so the body restates the terms you are approving.

Only a party the request is waiting on may approve it; approvalRequired on the request says whether that is you. Approving a createOESAgreement request is your ratification of the control agreement, which then becomes active.

The decision is carried out asynchronously. Poll GET /atlas/requests/{requestId} to follow the request to completed.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
length ≥ 1

ID of the request to approve

Body Params

The terms you are approving the request on. Every field in approval must match the request; if one does not, nothing is recorded and the call fails with 409.

approval
required

The terms specific to the request's type. Must be the schema matching type.

string
enum
required
Defaults to createOESAgreement

The kind of change a request represents. More types will be added; ignore requests of a type you do not recognize.

  • createOESAgreement - The creation of a new Off-Exchange Settlement control agreement between the pledgor (the trader) and the secured party (the exchange).
Allowed:
Headers
string
required
^[0-9A-Fa-f]{128,160}$

A hex-encoded Ed25519 signature of timestamp_epoch_seconds + uppercase(http_method) + request_path + request_body.

int64
required

Current timestamp, represented as unix epoch seconds

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json