--- title: "Update Policy Rule" method: PATCH path: "/v1/policies/{policy_id}/rules/{rule_id}" tags: ["Policies"] --- # Update Policy Rule `PATCH /v1/policies/{policy_id}/rules/{rule_id}` Update a rule by policy ID and rule ID. ## Path parameters - `policy_id` string, required - `rule_id` string, required ## Headers - `privy-app-id` string, required — ID of your Privy app. - `privy-authorization-signature` string — Request authorization signature. If multiple signatures are required, they should be comma separated. - `privy-request-expiry` string — Request expiry. Value is a Unix timestamp in milliseconds representing the deadline by which the request must be processed. ## Request body - PolicyRuleRequestBody — The rules that apply to each method the policy covers. - `action` 'ALLOW' | 'DENY', required — The action to take when a policy rule matches. - `conditions` PolicyCondition[], required - union — A condition that must be true for the rule action to be applied. - object — The verbatim Ethereum transaction object in an eth_signTransaction or eth_sendTransaction request. - `field` 'to' | 'value' | 'chain_id', required — Ethereum transaction-level fields that can be referenced in a policy condition. - `field_source` 'ethereum_transaction', required - `operator` 'eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'in_condition_set' | 'contains' | 'starts_with' | 'ends_with', required — Operator to use for policy conditions. - `value` union, required — Value to compare against in a policy condition. Can be a single string or an array of strings. - string - string[] - object — The decoded calldata in a smart contract interaction as the smart contract method's parameters. Note that 'ethereum_calldata' conditions must contain an abi parameter with the JSON ABI of the smart contract. - `abi` object[], required — A Solidity ABI definition for decoding smart contract calldata. - `anonymous` boolean - `inputs` AbiParameter[] - `components` object[] - … - `indexed` boolean - `internalType` string - `name` string - `type` string, required - `name` string - `outputs` AbiParameter[] - `components` object[] - … - `indexed` boolean - `internalType` string - `name` string - `type` string, required - `stateMutability` 'pure' | 'view' | 'nonpayable' | 'payable' - `type` 'function' | 'constructor' | 'event' | 'fallback' | 'receive', required - `field` string, required - `field_source` 'ethereum_calldata', required - `operator` 'eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'in_condition_set' | 'contains' | 'starts_with' | 'ends_with', required — Operator to use for policy conditions. - `value` union, required — Value to compare against in a policy condition. Can be a single string or an array of strings. - string - string[] - object — Attributes from the signing domain that will verify the signature. - `field` 'chainId' | 'verifyingContract' | 'chain_id' | 'verifying_contract', required — Supported fields for Ethereum typed data domain conditions. - `field_source` 'ethereum_typed_data_domain', required - `operator` 'eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'in_condition_set' | 'contains' | 'starts_with' | 'ends_with', required — Operator to use for policy conditions. - `value` union, required — Value to compare against in a policy condition. Can be a single string or an array of strings. - string - string[] - object — 'types' and 'primary_type' attributes of the TypedData JSON object defined in EIP-712. - `field` string, required - `field_source` 'ethereum_typed_data_message', required - `operator` 'eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'in_condition_set' | 'contains' | 'starts_with' | 'ends_with', required — Operator to use for policy conditions. - `typed_data` TypedDataInput, required — The typed data structure containing EIP-712 types and the primary type for typed data message policy conditions. - `primary_type` string, required - `types` TypedDataTypesInputParams, required — The type definitions for EIP-712 typed data signing. - `value` union, required — Value to compare against in a policy condition. Can be a single string or an array of strings. - string - string[] - object — Allowed contract addresses for eth_sign7702Authorization requests. - `field` 'contract', required - `field_source` 'ethereum_7702_authorization', required - `operator` 'eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'in_condition_set' | 'contains' | 'starts_with' | 'ends_with', required — Operator to use for policy conditions. - `value` union, required — Value to compare against in a policy condition. Can be a single string or an array of strings. - string - string[] - object — A Tempo (type 118) transaction-level field. Evaluated once per transaction (not per call). - `field` 'fee_token' | 'fee_payer_signature' | 'nonce_key' | 'valid_before' | 'valid_after', required — Tempo (type 118) transaction-level fields that can be referenced in a policy condition. - `field_source` 'tempo_transaction', required - `operator` 'eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'in_condition_set' | 'contains' | 'starts_with' | 'ends_with', required — Operator to use for policy conditions. - `value` union, required — Value to compare against in a policy condition. Can be a single string or an array of strings. - string - string[] - object — Solana Program attributes, enables allowlisting Solana Programs. - `field` 'programId', required - `field_source` 'solana_program_instruction', required - `operator` 'eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'in_condition_set' | 'contains' | 'starts_with' | 'ends_with', required — Operator to use for policy conditions. - `value` union, required — Value to compare against in a policy condition. Can be a single string or an array of strings. - string - string[] - object — Solana System Program attributes, including more granular Transfer instruction fields. - `field` 'instructionName' | 'Transfer.from' | 'Transfer.to' | 'Transfer.lamports', required — Supported fields for Solana System Program conditions including Transfer instruction fields. - `field_source` 'solana_system_program_instruction', required - `operator` 'eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'in_condition_set' | 'contains' | 'starts_with' | 'ends_with', required — Operator to use for policy conditions. - `value` union, required — Value to compare against in a policy condition. Can be a single string or an array of strings. - string - string[] - object — Solana Token Program attributes, including more granular TransferChecked instruction fields. - `field` 'instructionName' | 'Transfer.source' | 'Transfer.destination' | 'Transfer.authority' | 'Transfer.amount' | 'TransferChecked.source' | 'TransferChecked.destination' | 'TransferChecked.authority' | 'TransferChecked.amount' | 'TransferChecked.mint' | 'Burn.account' | 'Burn.mint' | 'Burn.authority' | 'Burn.amount' | 'MintTo.mint' | 'MintTo.account' | 'MintTo.authority' | 'MintTo.amount' | 'CloseAccount.account' | 'CloseAccount.destination' | 'CloseAccount.authority' | 'InitializeAccount3.account' | 'InitializeAccount3.mint' | 'InitializeAccount3.owner', required — Supported fields for Solana Token Program conditions including Transfer, TransferChecked, Burn, MintTo, CloseAccount, and InitializeAccount3 instruction fields. - `field_source` 'solana_token_program_instruction', required - `operator` 'eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'in_condition_set' | 'contains' | 'starts_with' | 'ends_with', required — Operator to use for policy conditions. - `value` union, required — Value to compare against in a policy condition. Can be a single string or an array of strings. - string - string[] - object — System attributes, including current unix timestamp (in seconds). - `field` 'current_unix_timestamp', required - `field_source` 'system', required - `operator` 'eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'in_condition_set' | 'contains' | 'starts_with' | 'ends_with', required — Operator to use for policy conditions. - `value` union, required — Value to compare against in a policy condition. Can be a single string or an array of strings. - string - string[] - object — TRON transaction fields for TransferContract and TriggerSmartContract transaction types. - `field` 'TransferContract.to_address' | 'TransferContract.amount' | 'TriggerSmartContract.contract_address' | 'TriggerSmartContract.call_value' | 'TriggerSmartContract.token_id' | 'TriggerSmartContract.call_token_value', required — Supported TRON transaction fields for TransferContract and TriggerSmartContract in format "TransactionType.field_name". - `field_source` 'tron_transaction', required - `operator` 'eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'in_condition_set' | 'contains' | 'starts_with' | 'ends_with', required — Operator to use for policy conditions. - `value` union, required — Value to compare against in a policy condition. Can be a single string or an array of strings. - string - string[] - object — Decoded calldata from a TRON TriggerSmartContract interaction. - `abi` object[], required — A Solidity ABI definition for decoding smart contract calldata. - `anonymous` boolean - `inputs` AbiParameter[] - `components` object[] - … - `indexed` boolean - `internalType` string - `name` string - `type` string, required - `name` string - `outputs` AbiParameter[] - `components` object[] - … - `indexed` boolean - `internalType` string - `name` string - `type` string, required - `stateMutability` 'pure' | 'view' | 'nonpayable' | 'payable' - `type` 'function' | 'constructor' | 'event' | 'fallback' | 'receive', required - `field` string, required - `field_source` 'tron_trigger_smart_contract_data', required - `operator` 'eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'in_condition_set' | 'contains' | 'starts_with' | 'ends_with', required — Operator to use for policy conditions. - `value` union, required — Value to compare against in a policy condition. Can be a single string or an array of strings. - string - string[] - object — SUI transaction command attributes, enables allowlisting specific command types. Allowed commands: 'TransferObjects', 'SplitCoins', 'MergeCoins'. Only 'eq' and 'in' operators are supported. - `field` 'commandName', required - `field_source` 'sui_transaction_command', required - `operator` union, required — Operator to use for SUI transaction command conditions. Only 'eq' and 'in' are supported for command names. - 'eq' - 'in' - `value` union, required — Command name(s) to match. Must be one of: 'TransferObjects', 'SplitCoins', 'MergeCoins' - 'TransferObjects' | 'SplitCoins' | 'MergeCoins' — SUI transaction commands allowlist for raw_sign endpoint policy evaluation - SuiCommandName[] - object — SUI TransferObjects command attributes, including recipient and amount fields. - `field` 'recipient' | 'amount', required — Supported fields for SUI TransferObjects command conditions. Only 'recipient' and 'amount' are supported. - `field_source` 'sui_transfer_objects_command', required - `operator` 'eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'in_condition_set' | 'contains' | 'starts_with' | 'ends_with', required — Operator to use for policy conditions. - `value` union, required — Value to compare against in a policy condition. Can be a single string or an array of strings. - string - string[] - object — Condition on the original wallet action API request body fields. - `field` string, required - `field_source` 'action_request_body', required - `operator` 'eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'in_condition_set' | 'contains' | 'starts_with' | 'ends_with', required — Operator to use for policy conditions. - `value` union, required — Value to compare against in a policy condition. Can be a single string or an array of strings. - string - string[] - object — Condition referencing an aggregation value. The field must start with "aggregation." followed by the aggregation ID. - `field` string, required - `field_source` 'reference', required - `operator` 'eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'in_condition_set' | 'contains' | 'starts_with' | 'ends_with', required — Operator to use for policy conditions. - `value` union, required — Value to compare against in a policy condition. Can be a single string or an array of strings. - string - string[] - object — Condition on the message being signed (e.g. in personal_sign). - `field` 'content' | 'byte_length', required — Supported fields for message signing conditions. - `field_source` 'message', required - `operator` 'eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'in_condition_set' | 'contains' | 'starts_with' | 'ends_with', required — Operator to use for policy conditions. - `value` union, required — Value to compare against in a policy condition. Can be a single string or an array of strings. - string - string[] - `method` 'eth_sendTransaction' | 'eth_signTransaction' | 'eth_signUserOperation' | 'eth_signTypedData_v4' | 'personal_sign' | 'eth_sign7702Authorization' | 'wallet_sendCalls' | 'signTransaction' | 'signAndSendTransaction' | 'signMessage' | 'exportPrivateKey' | 'exportSeedPhrase' | 'signTransactionBytes' | 'signRawMessageBytes' | 'tron_sendTransaction' | 'tron_signTransaction' | 'earn_deposit' | 'earn_withdraw' | 'transfer' | '*', required — Method the rule applies to. - `name` string, required ## Response `200` Updated policy rule object. - PolicyRuleResponse — A rule that defines the conditions and action to take if the conditions are true. - `action` 'ALLOW' | 'DENY', required — The action to take when a policy rule matches. - `conditions` PolicyCondition[], required - union — A condition that must be true for the rule action to be applied. - object — The verbatim Ethereum transaction object in an eth_signTransaction or eth_sendTransaction request. - `field` 'to' | 'value' | 'chain_id', required — Ethereum transaction-level fields that can be referenced in a policy condition. - `field_source` 'ethereum_transaction', required - `operator` 'eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'in_condition_set' | 'contains' | 'starts_with' | 'ends_with', required — Operator to use for policy conditions. - `value` union, required — Value to compare against in a policy condition. Can be a single string or an array of strings. - string - string[] - object — The decoded calldata in a smart contract interaction as the smart contract method's parameters. Note that 'ethereum_calldata' conditions must contain an abi parameter with the JSON ABI of the smart contract. - `abi` object[], required — A Solidity ABI definition for decoding smart contract calldata. - `anonymous` boolean - `inputs` AbiParameter[] - `components` object[] - … - `indexed` boolean - `internalType` string - `name` string - `type` string, required - `name` string - `outputs` AbiParameter[] - `components` object[] - … - `indexed` boolean - `internalType` string - `name` string - `type` string, required - `stateMutability` 'pure' | 'view' | 'nonpayable' | 'payable' - `type` 'function' | 'constructor' | 'event' | 'fallback' | 'receive', required - `field` string, required - `field_source` 'ethereum_calldata', required - `operator` 'eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'in_condition_set' | 'contains' | 'starts_with' | 'ends_with', required — Operator to use for policy conditions. - `value` union, required — Value to compare against in a policy condition. Can be a single string or an array of strings. - string - string[] - object — Attributes from the signing domain that will verify the signature. - `field` 'chainId' | 'verifyingContract' | 'chain_id' | 'verifying_contract', required — Supported fields for Ethereum typed data domain conditions. - `field_source` 'ethereum_typed_data_domain', required - `operator` 'eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'in_condition_set' | 'contains' | 'starts_with' | 'ends_with', required — Operator to use for policy conditions. - `value` union, required — Value to compare against in a policy condition. Can be a single string or an array of strings. - string - string[] - object — 'types' and 'primary_type' attributes of the TypedData JSON object defined in EIP-712. - `field` string, required - `field_source` 'ethereum_typed_data_message', required - `operator` 'eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'in_condition_set' | 'contains' | 'starts_with' | 'ends_with', required — Operator to use for policy conditions. - `typed_data` TypedDataInput, required — The typed data structure containing EIP-712 types and the primary type for typed data message policy conditions. - `primary_type` string, required - `types` TypedDataTypesInputParams, required — The type definitions for EIP-712 typed data signing. - `value` union, required — Value to compare against in a policy condition. Can be a single string or an array of strings. - string - string[] - object — Allowed contract addresses for eth_sign7702Authorization requests. - `field` 'contract', required - `field_source` 'ethereum_7702_authorization', required - `operator` 'eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'in_condition_set' | 'contains' | 'starts_with' | 'ends_with', required — Operator to use for policy conditions. - `value` union, required — Value to compare against in a policy condition. Can be a single string or an array of strings. - string - string[] - object — A Tempo (type 118) transaction-level field. Evaluated once per transaction (not per call). - `field` 'fee_token' | 'fee_payer_signature' | 'nonce_key' | 'valid_before' | 'valid_after', required — Tempo (type 118) transaction-level fields that can be referenced in a policy condition. - `field_source` 'tempo_transaction', required - `operator` 'eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'in_condition_set' | 'contains' | 'starts_with' | 'ends_with', required — Operator to use for policy conditions. - `value` union, required — Value to compare against in a policy condition. Can be a single string or an array of strings. - string - string[] - object — Solana Program attributes, enables allowlisting Solana Programs. - `field` 'programId', required - `field_source` 'solana_program_instruction', required - `operator` 'eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'in_condition_set' | 'contains' | 'starts_with' | 'ends_with', required — Operator to use for policy conditions. - `value` union, required — Value to compare against in a policy condition. Can be a single string or an array of strings. - string - string[] - object — Solana System Program attributes, including more granular Transfer instruction fields. - `field` 'instructionName' | 'Transfer.from' | 'Transfer.to' | 'Transfer.lamports', required — Supported fields for Solana System Program conditions including Transfer instruction fields. - `field_source` 'solana_system_program_instruction', required - `operator` 'eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'in_condition_set' | 'contains' | 'starts_with' | 'ends_with', required — Operator to use for policy conditions. - `value` union, required — Value to compare against in a policy condition. Can be a single string or an array of strings. - string - string[] - object — Solana Token Program attributes, including more granular TransferChecked instruction fields. - `field` 'instructionName' | 'Transfer.source' | 'Transfer.destination' | 'Transfer.authority' | 'Transfer.amount' | 'TransferChecked.source' | 'TransferChecked.destination' | 'TransferChecked.authority' | 'TransferChecked.amount' | 'TransferChecked.mint' | 'Burn.account' | 'Burn.mint' | 'Burn.authority' | 'Burn.amount' | 'MintTo.mint' | 'MintTo.account' | 'MintTo.authority' | 'MintTo.amount' | 'CloseAccount.account' | 'CloseAccount.destination' | 'CloseAccount.authority' | 'InitializeAccount3.account' | 'InitializeAccount3.mint' | 'InitializeAccount3.owner', required — Supported fields for Solana Token Program conditions including Transfer, TransferChecked, Burn, MintTo, CloseAccount, and InitializeAccount3 instruction fields. - `field_source` 'solana_token_program_instruction', required - `operator` 'eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'in_condition_set' | 'contains' | 'starts_with' | 'ends_with', required — Operator to use for policy conditions. - `value` union, required — Value to compare against in a policy condition. Can be a single string or an array of strings. - string - string[] - object — System attributes, including current unix timestamp (in seconds). - `field` 'current_unix_timestamp', required - `field_source` 'system', required - `operator` 'eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'in_condition_set' | 'contains' | 'starts_with' | 'ends_with', required — Operator to use for policy conditions. - `value` union, required — Value to compare against in a policy condition. Can be a single string or an array of strings. - string - string[] - object — TRON transaction fields for TransferContract and TriggerSmartContract transaction types. - `field` 'TransferContract.to_address' | 'TransferContract.amount' | 'TriggerSmartContract.contract_address' | 'TriggerSmartContract.call_value' | 'TriggerSmartContract.token_id' | 'TriggerSmartContract.call_token_value', required — Supported TRON transaction fields for TransferContract and TriggerSmartContract in format "TransactionType.field_name". - `field_source` 'tron_transaction', required - `operator` 'eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'in_condition_set' | 'contains' | 'starts_with' | 'ends_with', required — Operator to use for policy conditions. - `value` union, required — Value to compare against in a policy condition. Can be a single string or an array of strings. - string - string[] - object — Decoded calldata from a TRON TriggerSmartContract interaction. - `abi` object[], required — A Solidity ABI definition for decoding smart contract calldata. - `anonymous` boolean - `inputs` AbiParameter[] - `components` object[] - … - `indexed` boolean - `internalType` string - `name` string - `type` string, required - `name` string - `outputs` AbiParameter[] - `components` object[] - … - `indexed` boolean - `internalType` string - `name` string - `type` string, required - `stateMutability` 'pure' | 'view' | 'nonpayable' | 'payable' - `type` 'function' | 'constructor' | 'event' | 'fallback' | 'receive', required - `field` string, required - `field_source` 'tron_trigger_smart_contract_data', required - `operator` 'eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'in_condition_set' | 'contains' | 'starts_with' | 'ends_with', required — Operator to use for policy conditions. - `value` union, required — Value to compare against in a policy condition. Can be a single string or an array of strings. - string - string[] - object — SUI transaction command attributes, enables allowlisting specific command types. Allowed commands: 'TransferObjects', 'SplitCoins', 'MergeCoins'. Only 'eq' and 'in' operators are supported. - `field` 'commandName', required - `field_source` 'sui_transaction_command', required - `operator` union, required — Operator to use for SUI transaction command conditions. Only 'eq' and 'in' are supported for command names. - 'eq' - 'in' - `value` union, required — Command name(s) to match. Must be one of: 'TransferObjects', 'SplitCoins', 'MergeCoins' - 'TransferObjects' | 'SplitCoins' | 'MergeCoins' — SUI transaction commands allowlist for raw_sign endpoint policy evaluation - SuiCommandName[] - object — SUI TransferObjects command attributes, including recipient and amount fields. - `field` 'recipient' | 'amount', required — Supported fields for SUI TransferObjects command conditions. Only 'recipient' and 'amount' are supported. - `field_source` 'sui_transfer_objects_command', required - `operator` 'eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'in_condition_set' | 'contains' | 'starts_with' | 'ends_with', required — Operator to use for policy conditions. - `value` union, required — Value to compare against in a policy condition. Can be a single string or an array of strings. - string - string[] - object — Condition on the original wallet action API request body fields. - `field` string, required - `field_source` 'action_request_body', required - `operator` 'eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'in_condition_set' | 'contains' | 'starts_with' | 'ends_with', required — Operator to use for policy conditions. - `value` union, required — Value to compare against in a policy condition. Can be a single string or an array of strings. - string - string[] - object — Condition referencing an aggregation value. The field must start with "aggregation." followed by the aggregation ID. - `field` string, required - `field_source` 'reference', required - `operator` 'eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'in_condition_set' | 'contains' | 'starts_with' | 'ends_with', required — Operator to use for policy conditions. - `value` union, required — Value to compare against in a policy condition. Can be a single string or an array of strings. - string - string[] - object — Condition on the message being signed (e.g. in personal_sign). - `field` 'content' | 'byte_length', required — Supported fields for message signing conditions. - `field_source` 'message', required - `operator` 'eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'in_condition_set' | 'contains' | 'starts_with' | 'ends_with', required — Operator to use for policy conditions. - `value` union, required — Value to compare against in a policy condition. Can be a single string or an array of strings. - string - string[] - `id` string, required - `method` 'eth_sendTransaction' | 'eth_signTransaction' | 'eth_signUserOperation' | 'eth_signTypedData_v4' | 'personal_sign' | 'eth_sign7702Authorization' | 'wallet_sendCalls' | 'signTransaction' | 'signAndSendTransaction' | 'signMessage' | 'exportPrivateKey' | 'exportSeedPhrase' | 'signTransactionBytes' | 'signRawMessageBytes' | 'tron_sendTransaction' | 'tron_signTransaction' | 'earn_deposit' | 'earn_withdraw' | 'transfer' | '*', required — Method the rule applies to. - `name` string, required --- [API](https://skmtc.net/privy-io/apis/privy-api.md) · [All operations](https://skmtc.net/privy-io/apis/privy-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/privy-io/privy-api/revisions/bb2eb34156cc/schema)