Create or update the policy attached to an agent wallet

Reference currency the caps are denominated in, as an ISO 4217 code (e.g. EUR, USD, JPY). Any code the rate oracle can quote works — no enum.

Per-signature ceiling, expressed as a non-negative integer in the smallest sub-unit of the policy reference currency. Null = no cap.

Threshold (same encoding as maxAmountPerPaymentRef) above which evaluateIntent returns require_human. Null = never require human approval.

Volatility tolerance in basis points (100 = 1%, max 10000 = 100%) applied when re-validating an already-approved intent against a freshly re-priced amount. Absorbs rate drift between the human approval and the signature: a retry is honored while the value stays within this margin of the approved value, otherwise it is re-escalated for a fresh human decision. Null/0 = strict (no tolerance).

IANA time zone the budget windows are computed in (e.g. Europe/Paris). Null = UTC.

Spend envelope over the current calendar day (in the policy timezone). Same encoding as maxAmountPerPaymentRef. Null = no daily envelope.

Spend envelope over the current calendar week (Monday→Sunday, in the policy timezone). Same encoding as maxAmountPerPaymentRef. Null = no weekly envelope.

Spend envelope over the current calendar month (in the policy timezone). Same encoding as maxAmountPerPaymentRef. Null = no monthly envelope.

Entity UUID

Creation date (ISO 8601)

Last update date (ISO 8601)

Reference currency the caps are denominated in, as an ISO 4217 code (e.g. EUR, USD, JPY). Any code the rate oracle can quote works — no enum.

Per-signature ceiling, expressed as a non-negative integer in the smallest sub-unit of the policy reference currency. Null = no cap.

Threshold (same encoding as maxAmountPerPaymentRef) above which evaluateIntent returns require_human. Null = never require human approval.

Volatility tolerance in basis points (100 = 1%, max 10000 = 100%) applied when re-validating an already-approved intent against a freshly re-priced amount. Absorbs rate drift between the human approval and the signature: a retry is honored while the value stays within this margin of the approved value, otherwise it is re-escalated for a fresh human decision. Null/0 = strict (no tolerance).

IANA time zone the budget windows are computed in (e.g. Europe/Paris). Null = UTC.

Spend envelope over the current calendar day (in the policy timezone). Same encoding as maxAmountPerPaymentRef. Null = no daily envelope.

Spend envelope over the current calendar week (Monday→Sunday, in the policy timezone). Same encoding as maxAmountPerPaymentRef. Null = no weekly envelope.

Spend envelope over the current calendar month (in the policy timezone). Same encoding as maxAmountPerPaymentRef. Null = no monthly envelope.

Per-wallet emergency stop ("kill switch"). When true, all payment requests for this wallet are denied until an operator releases it.