Update settlement
All relationship writes are tenant-scoped and atomic. Accounting-frozen settlements return 409.
Authorizations
Organization API key created in Grain Settings → API. The key determines the organization and is limited to its assigned resource scopes. Write scopes imply the corresponding read scope.
Headers
Required with OAuth access tokens. Optional with organization API keys; if supplied, it must match the key's organization.
Path Parameters
Resource ID
Body
All fields are optional; null clears nullable fields. MATCHED and RECONCILED are read-only accounting states.
STRIPE, PUSHPAY, SUBSPLASH, TITHELY, PLANNING_CENTER, ROCK_RMS, RAMP, DIVVY, MANUAL x >= 0x >= 0x >= 03x >= 0PENDING, IN_TRANSIT, DEPOSITED, FAILED, CANCELLED GROSS, NET 1000010000100Response
Updated settlement
Recorded settlement values plus independently calculated linked-contribution totals. Accounting and bank-link state are read-only; raw provider metadata, sync diagnostics, accounting details, and fingerprints are excluded.
STRIPE, PUSHPAY, SUBSPLASH, TITHELY, PLANNING_CENTER, ROCK_RMS, RAMP, DIVVY, MANUAL Calendar day represented as a UTC-midnight ISO timestamp.
3PENDING, IN_TRANSIT, DEPOSITED, MATCHED, RECONCILED, FAILED, CANCELLED Calendar day represented as a UTC-midnight ISO timestamp.
GROSS, NET