inventory.reclaim_expired

Sweep active holds past their expires_at, returning their reserved units. Each reclaimed exactly once.

• Scope: inventory.reserve
• System: no
• Reachable from: POST /v1/commands/inventory.reclaim_expired (tenant credential) · MCP tool inventory.reclaim_expired · SDK client.call('inventory.reclaim_expired', …)
• Events: inventory.expired

Input (JSON Schema)

{
  "properties": {},
  "type": "object"
}

Result (200)

{
  "additionalProperties": false,
  "properties": {
    "reclaimed": {
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "type": "integer"
    }
  },
  "required": [
    "reclaimed"
  ],
  "type": "object"
}

Errors

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