Approve or reject another staff member's network token proposal (staff)

POST/cards/network-tokens/proposals/{id}/reviews

Staff with cards:tokens:approve, a fresh step-up and a subject different from the maker (403 otherwise) approve or reject against the proposal's content_sha256. An approval applies the change and queues its commands in the same transaction; a proposal that no longer matches the token is conflict and can only be rejected. A reviewed proposal is conflict.

Path parameters

idstringRequired

Headers

Idempotency-KeystringRequired

Send on every write that creates or changes money or state; a replay with the same key returns the original result with 200.

Body parameters

approvebooleanRequired

content_sha256stringRequired

reasonstringRequired

Returns

200 OK

actorstringRequired

atstring · date-timeRequired

content_sha256stringRequired

idstringRequired

requestobjectRequired

ProposalRequest 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 nullOptional

Controls 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 stringsOptional

channelsarray of stringsOptional

Empty means every channel of the token's domain

daily_limit_amountintegerOptional

per_transaction_limit_amountintegerOptional

valid_untilstring · date-time or nullOptional

expected_sequenceintegerOptional

kindstringRequired

new_card_idstringOptional

Example card_2tVh8nqLxq4GbDe0K1F6S9zRcWm

old_card_idstringOptional

Example card_2tVh8nqLxq4GbDe0K1F6S9zRcWm

reasonstringRequired

token_idstringOptional

reviewobject or nullOptional

Review is the independent decision on a proposal and what its approval changed.

6 child attributes

actorstringRequired

applied_token_idsarray of stringsRequired

approvebooleanRequired

atstring · date-timeRequired

content_sha256stringRequired

reasonstringRequired

Errors

Every error is a problem document with a stable code. See Errors.

400401403404409412413422424429500503