warehouse.update

Update a warehouse: name, kind, address and ship-from origin, routing priority, overselling policy, and whether it is active or the default. Deactivating the default, clearing the default flag without electing another, or making an inactive warehouse the default, is refused by name.

• Scope: inventory.adjust
• System: no
• Reachable from: POST /v1/commands/warehouse.update (tenant credential) · MCP tool warehouse.update · SDK client.call('warehouse.update', …)
• Events: warehouse.updated, warehouse.activated, warehouse.deactivated

Input (JSON Schema)

{
  "properties": {
    "active": {
      "type": "boolean"
    },
    "addr_line1": {
      "anyOf": [
        {
          "maxLength": 200,
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "addr_line2": {
      "anyOf": [
        {
          "maxLength": 200,
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "city": {
      "anyOf": [
        {
          "maxLength": 120,
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "country_code": {
      "maxLength": 2,
      "minLength": 2,
      "type": "string"
    },
    "is_default": {
      "type": "boolean"
    },
    "kind": {
      "enum": [
        "physical",
        "virtual"
      ],
      "type": "string"
    },
    "name": {
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    },
    "origin_postal_code": {
      "maxLength": 32,
      "minLength": 1,
      "type": "string"
    },
    "oversell_extra_days": {
      "anyOf": [
        {
          "maximum": 365,
          "minimum": 0,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ]
    },
    "oversell_notice": {
      "type": "boolean"
    },
    "oversell_policy": {
      "enum": [
        "block",
        "allow"
      ],
      "type": "string"
    },
    "priority": {
      "maximum": 100000,
      "minimum": 0,
      "type": "integer"
    },
    "uf": {
      "anyOf": [
        {
          "maxLength": 8,
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "warehouse_id": {
      "type": "string"
    }
  },
  "type": "object"
}

Result (200)

{
  "additionalProperties": false,
  "properties": {
    "warehouse_id": {
      "type": "string"
    }
  },
  "required": [
    "warehouse_id"
  ],
  "type": "object"
}

Errors

validation_failed (400) · unauthorized (401) · forbidden (403) · conflict (409) · internal (500)