---
title: "Master Wallet Update Rule"
method: PATCH
path: "/v1/wallets/{walletId}/auto-settlements/rules/{id}"
tags: ["Auto Settlements"]
---

# Master Wallet Update Rule

`PATCH /v1/wallets/{walletId}/auto-settlements/rules/{id}`

This endpoint allows you to update an existing auto-settlement rule for a specific wallet. By providing the necessary parameters in the request body, you can modify the conditions and actions for the auto-settlement process.

## Request Body Parameters

| Parameter           | Type                | Required | Description |
|---------------------|---------------------|----------|-----------------------------------------------------------------------------|
| type                | string              | No       | The settlement rule type: `withdraw`, `swap`, `gateway`, or `earn`. Sending it on an update migrates a legacy rule onto the explicit type system and applies the type validations; omit it to keep the rule's current behavior. |
| name                | string              | No       | The name of the auto-settlement rule. A descriptive title reflecting its purpose. |
| isActive            | boolean             | No       | Indicates whether the rule is currently active. `true` = enabled, `false` = disabled. |
| order               | string              | No       | The order in which this rule should be processed. Possible values: `FASTEST`, `CHEAPEST`, `RECOMMENDED`, `NO_SLIPPAGE`. |
| slippageTolerance   | string              | No       | The acceptable slippage tolerance (as a percentage). Example: `"5"` = 5% tolerance. |
| source              | object              | No       | Details about the source of the settlement.                                 |
| ├─ assets           | array of strings    | No       | List of asset types involved (e.g., `["USDT"]`).                            |
| ├─ minAmount        | string              | No       | The minimum amount required for settlement (e.g., `"1"`).                   |
| ├─ maxAmount        | string              | No       | The maximum amount that can be settled (e.g., `"1000"`).                    |
| ├─ blockchain       | string              | No       | The blockchain network used for the settlement.                             |
| destination         | object              | No       | Details about the destination of the settlement.                            |
| ├─ asset            | string              | No       | The asset type to which the settlement is directed.                         |
| ├─ address          | string              | No       | The address where the settlement will be sent.                              |
| ├─ blockchain       | string              | No       | The blockchain network for the destination.                                 |

## Request body

- object
  - `type` 'withdraw' | 'swap' | 'gateway' | 'earn' — Settlement rule type. Sending it on an update migrates a legacy rule onto the explicit type system; omit it to keep the rule's current behavior.
  - `destination` object
    - `address` string
    - `asset` string
    - `blockchain` string
  - `isActive` boolean
  - `name` string
  - `order` string
  - `slippageTolerance` string
  - `source` object
    - `assets` string[]
    - `blockchain` string
    - `maxAmount` string
    - `minAmount` string

## Response `200`

200

- object
  - `data` object
    - `createdAt` string
    - `destination` object
      - `address` string
      - `asset` string
      - `blockchain` string
    - `id` string
    - `isActive` boolean
    - `name` string
    - `order` string
    - `slippageTolerance` string
    - `source` object
      - `assets` string[]
      - `blockchain` string
      - `maxAmount` string
      - `minAmount` string
    - `updatedAt` string
  - `message` string
  - `statusCode` number

---

[API](https://skmtc.net/blockradar/apis/blockradar-documentation.md) · [All operations](https://skmtc.net/blockradar/apis/blockradar-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/blockradar/blockradar-documentation/versions/97f95b4cfc0d/schema)