An organisation can require a second operator to approve a stored corporate action plan before confirm runs. See Corporate actions for the create, preview, and confirm sequence.
Approve or reject a plan
Enabling the corporate-actions row in the organisation's approval policy requires a second operator before confirm on irreversible actions: partialRedemption, stockSplit (forward or reverse), rightsIssue, capitalDecrease, coordinatedDistribution, buyback (with a cash leg or enabled under the gate), cash or in-kind cashDividend and distribution, and in-kind bondCoupon.
Every record includes an approval block:
Non-staff callers (without governance or supplyManagement, organisation owner, or platform administrator roles) read only announced records, with internal actor fields returned as null and approvedByViewer as false (Who reads which records).
Submit a decision
After preview, a different operator reads the plan and posts planDigest as reviewedDigest to POST /api/:
curl -sS -X POST "$DALP_API_URL/api/v2/tokens/$ASSET_ID/corporate-actions/$CORPORATE_ACTION_ID/decisions" \
-H "X-Api-Key: $DALP_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"decision": "approve",
"reviewedDigest": "3b8f1d2c4a5e6f708192a3b4c5d6e7f8091a2b3c4d5e6f708192a3b4c5d6e7f8"
}'- Approve: Moves the record to
approved(onceapprovalsNeededreaches zero) so confirm can execute. Refused if the digest is stale orpayingTreasurylacks cash-leg funding. - Reject: Requires a non-empty
reasonand ends the record inaborted(viareleasingif custodial contracts were frozen) withapproval..state: "denied" - Step-up: Session-authenticated decisions require
walletVerification, while API-key decisions do not. - Cash dividends and distributions: Rejecting or acting after expiry first cancels the on-chain dividend using the checker's
governancewallet. If cancellation fails or stays queued, the record stayspreviewedand returns409 CORPORATE_(ACTION_ DIVIDEND_ DECLARED data.dividendId).
Decisions must satisfy the checker rules in Approve a corporate action. Refused decisions return DALP-12165 naming the rule in data.violation.
Expired windows and drift refusals
A decision arriving after the approval window closes (or a new create on the same token) ends the lapsed record in aborted (or releasing) with approval.. On cash dividends and distributions, the dividend cancels first using that caller's wallet proof. Reads never send transactions, so an untouched lapsed dividend stays previewed until cancelled.
Confirm returns DALP-12052 when no confirmable preview exists (for example, a drafted record or a cash dividend confirm missing its preview root and totals).
Confirm returns 409 CORPORATE_ (DALP-12056) if balances moved on a call: "all" buyback or rights exercises moved on a rights close, and 409 CORPORATE_ (DALP-12053) if a stock split's reference price moved. Re-preview a previewed record, or abort an approved record and raise a new action (using followsUpOn if a rights close already minted shares).
Policy configuration and waivers
Configure the gate via PUT /api/ (the corporate-actions row, also mapped to CORPORATE_). It starts off. Disabling it requires wallet verification and, if Administration approvals are active, a second owner or platform administrator.
When the row is off (organization-disabled) or no second owner exists (too-few-approvers), records open with policy: "not_ and waiver set. Confirm rechecks eligibility (except on cash dividends and distributions, which retain their waiver) and opens a pending decision if the organisation can now staff the gate.
For partial redemptions with a cash leg (denominationAsset, pricePerUnit, payingTreasury), see Tradable rights, cash legs and issuer calls.