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

# `settings.stock.update`

Update store-wide stock policy: default marketplace buffer, untracked quantity, restock-on-cancel/return, zero-when-archived.

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

## Payload

| field | type | required | notes |
|---|---|---|---|
| `buffer` | integer (0..10000) \| null | no |  |
| `untrackedQty` | integer (1..20000) \| null | no |  |
| `restockOnCancel` | boolean \| null | no |  |
| `restockOnReturn` | "always" \| "never" \| "ask" \| null | no |  |
| `zeroWhenArchived` | boolean \| null | no |  |

### JSON Schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "buffer": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0,
          "maximum": 10000
        },
        {
          "type": "null"
        }
      ]
    },
    "untrackedQty": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 1,
          "maximum": 20000
        },
        {
          "type": "null"
        }
      ]
    },
    "restockOnCancel": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ]
    },
    "restockOnReturn": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "always",
            "never",
            "ask"
          ]
        },
        {
          "type": "null"
        }
      ]
    },
    "zeroWhenArchived": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "additionalProperties": false
}
```