Propose a resume, a controls change or a card replacement for independent review (staff)
/cards/network-tokens/proposalsStaff with cards:tokens:write and a fresh step-up propose resuming a bank suspension, replacing a token's controls (both at the token's current sequence) or moving a card's tokens to a replacement card with the same holder, account, facility, network and kind. The Idempotency-Key replays per maker.
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
controlsobject or nullOptionalControls are per-token spending controls. They only ever restrict further than the card's own controls, which still apply to every token authorization.
5 child attributes
blocked_mccsarray of stringsOptionalchannelsarray of stringsOptionalEmpty means every channel of the token's domain
daily_limit_amountintegerOptionalper_transaction_limit_amountintegerOptionalvalid_untilstring · date-time or nullOptionalexpected_sequenceintegerOptionalkindstringRequirednew_card_idstringOptionalExample card_2tVh8nqLxq4GbDe0K1F6S9zRcWm
old_card_idstringOptionalExample card_2tVh8nqLxq4GbDe0K1F6S9zRcWm
reasonstringRequiredtoken_idstringOptionalReturns
200 OK
actorstringRequiredatstring · date-timeRequiredcontent_sha256stringRequiredidstringRequiredrequestobjectRequiredProposalRequest is a staff change that needs a second person: resuming a staff suspension, changing a token's controls, or moving a card's tokens to its replacement card.
7 child attributes
controlsobject or nullOptionalControls are per-token spending controls. They only ever restrict further than the card's own controls, which still apply to every token authorization.
5 child attributes
blocked_mccsarray of stringsOptionalchannelsarray of stringsOptionalEmpty means every channel of the token's domain
daily_limit_amountintegerOptionalper_transaction_limit_amountintegerOptionalvalid_untilstring · date-time or nullOptionalexpected_sequenceintegerOptionalkindstringRequirednew_card_idstringOptionalExample card_2tVh8nqLxq4GbDe0K1F6S9zRcWm
old_card_idstringOptionalExample card_2tVh8nqLxq4GbDe0K1F6S9zRcWm
reasonstringRequiredtoken_idstringOptionalreviewobject or nullOptionalReview is the independent decision on a proposal and what its approval changed.
6 child attributes
actorstringRequiredapplied_token_idsarray of stringsRequiredapprovebooleanRequiredatstring · date-timeRequiredcontent_sha256stringRequiredreasonstringRequiredErrors
Every error is a problem document with a stable code. See Errors.
400401403404409412413422424429500503