v1

latestOpenAPI 3.0.02026-08-04134348905.1 KB
Atlas Settlement Network

Authorize a settlement

Permissions required: Authorize Settlements

After your participant has proposed a settlement or accepted a settlement proposal, the details of the settlement must be authorized.

To authorize via API, the API key must have a special permission. Otherwise, authorization takes place in the app according to organization policy.

post/atlas/settlements/{settlementId}/authorize

Path parameters

settlementIdstring required

ID of settlement to authorize

Query parameters

participantIdstring required

ID of participant authorizing the settlement

Headers

Api-Signaturestring required

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

Construction example:

toHex(
  ed25519Sign(
    signing_key,
    '{}{}{}{}'.format(timestamp_epoch_seconds, toUpper(httpMethod), httpRequestPath, httpBody)
  )
)
Api-Timestampinteger required

Current timestamp, represented as unix epoch seconds

Request body

acceptorIdstring required
proposerIdstring required

Example request

{
  "walletAmounts": [
    {
      "assetType": "BTC",
      "quantity": "10.45234733"
    }
  ]
}