Propose reviewed annual issuer, recipient instructions and tax-delivery requirements
POST
/retirement/tax-policiesFresh dedicated retirement writer, then independent retirement approver. Only the implemented 2026 irs-2026-cash-retirement-v1 schema is accepted. The bank supplies reviewed issuer identity, complete recipient instructions, applicable deadlines and electronic-delivery disclosures with exact evidence/version. No production legal copy or future IRS schema is inferred.
Headers
Idempotency-KeystringRequiredSend on every write that creates or changes money or state; a replay with the same key returns the original result with 200.
Body parameters
delivery_disclosureobjectRequired9 child attributes
availability_throughstring · dateRequiredA business date, YYYY-MM-DD
hardware_softwarestringRequiredobtaining_paperstringRequiredpaper_defaultstringRequiredscope_and_durationstringRequiredterminationstringRequiredupdating_contactstringRequiredwithdrawal_and_confirmationstringRequiredwithdrawal_confirmationstringRequiredeffective_atstring · date-timeRequiredevidence_refstringRequiredevidence_sha256stringRequiredexpected_versionintegerRequiredfmv_and_rmd_deadlinestring · dateRequiredA business date, YYYY-MM-DD
instructionsobjectRequiredinstructions_versionstringRequiredissuerobjectRequired4 child attributes
addressobjectRequired6 child attributes
citystringRequiredcountrystringRequiredline1stringRequiredline2stringOptionalpostal_codestringRequiredstatestringRequiredeinstringRequiredlegal_namestringRequiredtelephonestringRequiredreasonstringRequiredrecipient_deadlinesobjectRequiredschema_revisionstringRequiredtax_yearintegerRequiredReturns
200 OK
content_sha256stringRequireddecided_atstring · date-time or nullOptionaldecided_bystringOptionalidstringRequiredproposed_atstring · date-timeRequiredproposed_bystringRequiredrequestobjectRequired13 child attributes
delivery_disclosureobjectRequired9 child attributes
availability_throughstring · dateRequiredA business date, YYYY-MM-DD
hardware_softwarestringRequiredobtaining_paperstringRequiredpaper_defaultstringRequiredscope_and_durationstringRequiredterminationstringRequiredupdating_contactstringRequiredwithdrawal_and_confirmationstringRequiredwithdrawal_confirmationstringRequiredeffective_atstring · date-timeRequiredevidence_refstringRequiredevidence_sha256stringRequiredexpected_versionintegerRequiredfmv_and_rmd_deadlinestring · dateRequiredA business date, YYYY-MM-DD
instructionsobjectRequiredinstructions_versionstringRequiredissuerobjectRequired4 child attributes
addressobjectRequired6 child attributes
citystringRequiredcountrystringRequiredline1stringRequiredline2stringOptionalpostal_codestringRequiredstatestringRequiredeinstringRequiredlegal_namestringRequiredtelephonestringRequiredreasonstringRequiredrecipient_deadlinesobjectRequiredschema_revisionstringRequiredtax_yearintegerRequiredstatusstringRequiredversionintegerRequiredErrors
Every error is a problem document with a stable code. See Errors.
400401403404409412413422424429500503