<!-- Extension API v0 — pre-1.0. Interfaces may change without notice until P2 seals the custom-code format. First-party extensions track HEAD. -->

# `settings.channel.update`

Update one marketplace channel's policy: push/pull switches, price rule, buffer, resend window, disconnect and buyer-mail policy.

- **scope**: `store:admin`
- **storefront-visible** (bumps the catalog generation): no
- **destructive**: no

## Payload

| field | type | required | notes |
|---|---|---|---|
| `channel` | string (/^[a-z0-9_]{2,24}$/) | yes |  |
| `patch` | object | yes |  |
| `  pushStock` | boolean \| null | no |  |
| `  pushPrice` | boolean \| null | no |  |
| `  pullOrders` | boolean \| null | no |  |
| `  pullStock` | boolean \| null | no |  |
| `  buffer` | integer (0..10000) \| null | no |  |
| `  minResendMinutes` | integer (0..60) \| null | no |  |
| `  disconnect` | "zero" \| "freeze" \| null | no |  |
| `  buyerMail` | "suppress" \| "send" \| null | no |  |
| `  autoApprove` | boolean \| null | no |  |
| `  pullIntervalSec` | integer (60..3600) \| null | no |  |
| `  priceRule` | object | no |  |
| `    base` | "price" \| "compareAt" \| null | no |  |
| `    markupBp` | integer (-5000..50000) \| null | no |  |
| `    addKurus` | integer (-10000000..10000000) \| null | no |  |
| `    rounding` | "90" \| "99" \| "none" \| "integer" \| null | no |  |
| `    floorKurus` | integer (0..9007199254740991) \| null | no |  |
| `    ceilingKurus` | integer (0..9007199254740991) \| null | no |  |
| `    maxChangeBp` | integer (0..100000) \| null | no |  |
| `    listPrice` | "sale" \| "compareAt" \| "markup" \| null | no |  |
| `    listMarkupBp` | integer (0..50000) \| null | no |  |

### JSON Schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "channel": {
      "type": "string",
      "pattern": "^[a-z0-9_]{2,24}$"
    },
    "patch": {
      "type": "object",
      "properties": {
        "pushStock": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ]
        },
        "pushPrice": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ]
        },
        "pullOrders": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ]
        },
        "pullStock": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ]
        },
        "buffer": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0,
              "maximum": 10000
            },
            {
              "type": "null"
            }
          ]
        },
        "minResendMinutes": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0,
              "maximum": 60
            },
            {
              "type": "null"
            }
          ]
        },
        "disconnect": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "zero",
                "freeze"
              ]
            },
            {
              "type": "null"
            }
          ]
        },
        "buyerMail": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "suppress",
                "send"
              ]
            },
            {
              "type": "null"
            }
          ]
        },
        "autoApprove": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ]
        },
        "pullIntervalSec": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 60,
              "maximum": 3600
            },
            {
              "type": "null"
            }
          ]
        },
        "priceRule": {
          "type": "object",
          "properties": {
            "base": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "price",
                    "compareAt"
                  ]
                },
                {
                  "type": "null"
                }
              ]
            },
            "markupBp": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": -5000,
                  "maximum": 50000
                },
                {
                  "type": "null"
                }
              ]
            },
            "addKurus": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": -10000000,
                  "maximum": 10000000
                },
                {
                  "type": "null"
                }
              ]
            },
            "rounding": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "90",
                    "99",
                    "none",
                    "integer"
                  ]
                },
                {
                  "type": "null"
                }
              ]
            },
            "floorKurus": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 9007199254740991
                },
                {
                  "type": "null"
                }
              ]
            },
            "ceilingKurus": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 9007199254740991
                },
                {
                  "type": "null"
                }
              ]
            },
            "maxChangeBp": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 100000
                },
                {
                  "type": "null"
                }
              ]
            },
            "listPrice": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "sale",
                    "compareAt",
                    "markup"
                  ]
                },
                {
                  "type": "null"
                }
              ]
            },
            "listMarkupBp": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 50000
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "additionalProperties": false
        }
      },
      "additionalProperties": false
    }
  },
  "required": [
    "channel",
    "patch"
  ],
  "additionalProperties": false
}
```