# Import storage arrangement

Source: https://holofolder.com/app/docs/reference/collection/import-storage-arrangement

POST https://app.holofolder.com/app/api/v1/storage/imports/arrangement

OpenAPI operation (parameters, authentication, request body and responses):

```json
{
  "operationId": "import_storage_arrangement",
  "summary": "Import storage arrangement",
  "description": " Migration 093 adds committed terminal noncommit proofs: REST 409 storage_creation_rejected or storage_import_rejected, MCP isError with strict error.rejection (outcome, original operationId, known code, inventoryRevision). Exact accepted/rejected replay is permanent and precedes mutable reconstruction after current authority checks. Arbitrary conflicts, billing, cancellation, failed COMMIT and network errors remain unknown. Consumers must bind the trusted response to the original family, immutable intent and owner/session scope; proof alone never authorizes discard. Fresh complete current reads and explicit reconciliation are a separate consumer gate. MCP outputSchema describes accepted receipts only; holofolder.com/errorSchemas declares errors. Atomic JSON v2 arrangement into an empty or target-only native collection with an already identical copied manifest. Every copy needs an explicit add or versioned existing-copy move. Retain the immutable request after unknown outcome. Does not replace collections/configuration, import assets, restore changed same-owner snapshots or authorize backup IDs.\n\nRequired permissions: `collection:write`, `binders:write`. MCP tool: `import_storage_arrangement`.",
  "tags": [
    "Collection"
  ],
  "security": [
    {
      "apiKey": []
    }
  ],
  "parameters": [],
  "x-max-body-bytes": 8388608,
  "requestBody": {
    "required": true,
    "content": {
      "application/json": {
        "schema": {
          "$schema": "https://json-schema.org/draft/2020-12/schema",
          "type": "object",
          "properties": {
            "version": {
              "type": "number",
              "const": 1
            },
            "operationId": {
              "type": "string",
              "minLength": 8,
              "maxLength": 100
            },
            "inventoryRevision": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            "destinationCollectionId": {
              "type": "string",
              "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
            },
            "collections": {
              "minItems": 1,
              "maxItems": 32,
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "collectionId": {
                    "type": "string",
                    "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
                  },
                  "version": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  "layoutRevision": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  }
                },
                "required": [
                  "collectionId",
                  "version",
                  "layoutRevision"
                ],
                "additionalProperties": false
              }
            },
            "emptyDestinationSlots": {
              "maxItems": 4096,
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200
                  },
                  "version": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  "inventoryItemId": {
                    "anyOf": [
                      {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "itemVersion": {
                    "anyOf": [
                      {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "placementVersion": {
                    "anyOf": [
                      {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                },
                "required": [
                  "id",
                  "version",
                  "inventoryItemId",
                  "itemVersion",
                  "placementVersion"
                ],
                "additionalProperties": false
              }
            },
            "manifest": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "source": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200
                        },
                        "version": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200
                        }
                      },
                      "required": [
                        "id",
                        "version"
                      ],
                      "additionalProperties": false
                    },
                    "name": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200
                    },
                    "entries": {
                      "maxItems": 4096,
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200
                          },
                          "target": {
                            "anyOf": [
                              {
                                "oneOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "kind": {
                                        "type": "string",
                                        "const": "pokemon"
                                      },
                                      "pokemonId": {
                                        "type": "integer",
                                        "minimum": 1,
                                        "maximum": 9007199254740991
                                      }
                                    },
                                    "required": [
                                      "kind",
                                      "pokemonId"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "kind": {
                                        "type": "string",
                                        "const": "card"
                                      },
                                      "cardId": {
                                        "type": "string",
                                        "minLength": 1,
                                        "maxLength": 200
                                      },
                                      "language": {
                                        "type": "string",
                                        "enum": [
                                          "en",
                                          "fr",
                                          "de",
                                          "es",
                                          "it",
                                          "pt-br",
                                          "ja",
                                          "ko"
                                        ]
                                      },
                                      "finish": {
                                        "type": "string",
                                        "enum": [
                                          "normal",
                                          "holo",
                                          "reverse_holo",
                                          "double_rare",
                                          "ultra_rare",
                                          "illustration_rare",
                                          "special_illustration_rare",
                                          "secret_rare",
                                          "hyper_rare",
                                          "radiant_rare",
                                          "ace_spec",
                                          "amazing_rare",
                                          "shiny_rare",
                                          "jumbo"
                                        ]
                                      }
                                    },
                                    "required": [
                                      "kind",
                                      "cardId"
                                    ],
                                    "additionalProperties": false
                                  }
                                ]
                              },
                              {
                                "type": "null"
                              }
                            ]
                          }
                        },
                        "required": [
                          "id",
                          "target"
                        ],
                        "additionalProperties": false
                      }
                    }
                  },
                  "required": [
                    "source",
                    "name",
                    "entries"
                  ],
                  "additionalProperties": false
                },
                {
                  "type": "null"
                }
              ]
            },
            "slots": {
              "minItems": 1,
              "maxItems": 4096,
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200
                  },
                  "target": {
                    "anyOf": [
                      {
                        "oneOf": [
                          {
                            "type": "object",
                            "properties": {
                              "kind": {
                                "type": "string",
                                "const": "pokemon"
                              },
                              "pokemonId": {
                                "type": "integer",
                                "minimum": 1,
                                "maximum": 9007199254740991
                              }
                            },
                            "required": [
                              "kind",
                              "pokemonId"
                            ],
                            "additionalProperties": false
                          },
                          {
                            "type": "object",
                            "properties": {
                              "kind": {
                                "type": "string",
                                "const": "card"
                              },
                              "cardId": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 200
                              },
                              "language": {
                                "type": "string",
                                "enum": [
                                  "en",
                                  "fr",
                                  "de",
                                  "es",
                                  "it",
                                  "pt-br",
                                  "ja",
                                  "ko"
                                ]
                              },
                              "finish": {
                                "type": "string",
                                "enum": [
                                  "normal",
                                  "holo",
                                  "reverse_holo",
                                  "double_rare",
                                  "ultra_rare",
                                  "illustration_rare",
                                  "special_illustration_rare",
                                  "secret_rare",
                                  "hyper_rare",
                                  "radiant_rare",
                                  "ace_spec",
                                  "amazing_rare",
                                  "shiny_rare",
                                  "jumbo"
                                ]
                              }
                            },
                            "required": [
                              "kind",
                              "cardId"
                            ],
                            "additionalProperties": false
                          }
                        ]
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "status": {
                    "anyOf": [
                      {
                        "type": "string",
                        "enum": [
                          "collected",
                          "finalized",
                          "considering",
                          "wishlisted"
                        ]
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "wantedCards": {
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "card_id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200
                        },
                        "card_name": {
                          "type": "string",
                          "minLength": 1
                        },
                        "added_at": {
                          "type": "string"
                        },
                        "card_language": {
                          "type": "string",
                          "enum": [
                            "en",
                            "fr",
                            "de",
                            "es",
                            "it",
                            "pt-br",
                            "ja",
                            "ko"
                          ]
                        },
                        "card_finish": {
                          "type": "string",
                          "enum": [
                            "normal",
                            "holo",
                            "reverse_holo",
                            "double_rare",
                            "ultra_rare",
                            "illustration_rare",
                            "special_illustration_rare",
                            "secret_rare",
                            "hyper_rare",
                            "radiant_rare",
                            "ace_spec",
                            "amazing_rare",
                            "shiny_rare",
                            "jumbo"
                          ]
                        },
                        "card_image": {
                          "type": "string"
                        },
                        "card_set": {
                          "type": "string"
                        },
                        "rarity": {
                          "type": "string"
                        },
                        "local_id": {
                          "type": "string"
                        },
                        "illustrator": {
                          "type": "string"
                        },
                        "set_total": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 9007199254740991
                        },
                        "wanted_by": {
                          "maxItems": 2,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                          }
                        }
                      },
                      "required": [
                        "card_id",
                        "card_name",
                        "added_at"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "inventoryItemId": {
                    "anyOf": [
                      {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "presetOrigin": {
                    "anyOf": [
                      {
                        "type": "object",
                        "properties": {
                          "source": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 200
                              },
                              "version": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 200
                              }
                            },
                            "required": [
                              "id",
                              "version"
                            ],
                            "additionalProperties": false
                          },
                          "entryId": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200
                          }
                        },
                        "required": [
                          "source",
                          "entryId"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                },
                "required": [
                  "id",
                  "target",
                  "status",
                  "wantedCards",
                  "inventoryItemId",
                  "presetOrigin"
                ],
                "additionalProperties": false
              }
            },
            "copies": {
              "maxItems": 5000,
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "kind": {
                    "type": "string",
                    "enum": [
                      "add",
                      "existing"
                    ]
                  },
                  "item": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200
                      },
                      "identity": {
                        "oneOf": [
                          {
                            "type": "object",
                            "properties": {
                              "kind": {
                                "type": "string",
                                "const": "pokemon"
                              },
                              "pokemonId": {
                                "type": "integer",
                                "minimum": 1,
                                "maximum": 9007199254740991
                              }
                            },
                            "required": [
                              "kind",
                              "pokemonId"
                            ],
                            "additionalProperties": false
                          },
                          {
                            "type": "object",
                            "properties": {
                              "kind": {
                                "type": "string",
                                "const": "card"
                              },
                              "cardId": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 200
                              },
                              "language": {
                                "type": "string",
                                "enum": [
                                  "en",
                                  "fr",
                                  "de",
                                  "es",
                                  "it",
                                  "pt-br",
                                  "ja",
                                  "ko"
                                ]
                              },
                              "finish": {
                                "type": "string",
                                "enum": [
                                  "normal",
                                  "holo",
                                  "reverse_holo",
                                  "double_rare",
                                  "ultra_rare",
                                  "illustration_rare",
                                  "special_illustration_rare",
                                  "secret_rare",
                                  "hyper_rare",
                                  "radiant_rare",
                                  "ace_spec",
                                  "amazing_rare",
                                  "shiny_rare",
                                  "jumbo"
                                ]
                              }
                            },
                            "required": [
                              "kind",
                              "cardId"
                            ],
                            "additionalProperties": false
                          }
                        ]
                      },
                      "grading": {
                        "anyOf": [
                          {
                            "type": "object",
                            "properties": {
                              "provider": {
                                "oneOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "kind": {
                                        "type": "string",
                                        "const": "known"
                                      },
                                      "id": {
                                        "type": "string",
                                        "enum": [
                                          "psa",
                                          "ace",
                                          "cgc",
                                          "beckett"
                                        ]
                                      }
                                    },
                                    "required": [
                                      "kind",
                                      "id"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "kind": {
                                        "type": "string",
                                        "const": "custom"
                                      },
                                      "name": {
                                        "type": "string",
                                        "minLength": 1,
                                        "maxLength": 500
                                      }
                                    },
                                    "required": [
                                      "kind",
                                      "name"
                                    ],
                                    "additionalProperties": false
                                  }
                                ]
                              },
                              "grade": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 500
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "scale": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 500
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "designation": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 500
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "subgrades": {
                                "maxItems": 20,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "name": {
                                      "type": "string",
                                      "minLength": 1,
                                      "maxLength": 500
                                    },
                                    "grade": {
                                      "type": "string",
                                      "minLength": 1,
                                      "maxLength": 500
                                    }
                                  },
                                  "required": [
                                    "name",
                                    "grade"
                                  ],
                                  "additionalProperties": false
                                }
                              },
                              "certificate": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 500
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "holder": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 500
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "label": {
                                "type": "object",
                                "properties": {
                                  "variant": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "minLength": 1,
                                        "maxLength": 500
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "assetIds": {
                                    "maxItems": 20,
                                    "type": "array",
                                    "items": {
                                      "type": "string",
                                      "minLength": 1,
                                      "maxLength": 200
                                    }
                                  }
                                },
                                "required": [
                                  "variant",
                                  "assetIds"
                                ],
                                "additionalProperties": false
                              }
                            },
                            "required": [
                              "provider",
                              "grade",
                              "scale",
                              "designation",
                              "subgrades",
                              "certificate",
                              "holder",
                              "label"
                            ],
                            "additionalProperties": false
                          },
                          {
                            "type": "null"
                          }
                        ]
                      },
                      "acquiredAt": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "version": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991
                      }
                    },
                    "required": [
                      "id",
                      "identity",
                      "grading",
                      "acquiredAt",
                      "version"
                    ],
                    "additionalProperties": false
                  },
                  "ref": {
                    "anyOf": [
                      {
                        "type": "object",
                        "properties": {
                          "itemId": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200
                          },
                          "itemVersion": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991
                          },
                          "placement": {
                            "anyOf": [
                              {
                                "type": "object",
                                "properties": {
                                  "collectionId": {
                                    "type": "string",
                                    "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
                                  },
                                  "slot": {
                                    "type": "object",
                                    "properties": {
                                      "id": {
                                        "type": "string",
                                        "minLength": 1,
                                        "maxLength": 200
                                      },
                                      "version": {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "inventoryItemId": {
                                        "anyOf": [
                                          {
                                            "type": "string",
                                            "minLength": 1,
                                            "maxLength": 200
                                          },
                                          {
                                            "type": "null"
                                          }
                                        ]
                                      },
                                      "itemVersion": {
                                        "anyOf": [
                                          {
                                            "type": "integer",
                                            "minimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          {
                                            "type": "null"
                                          }
                                        ]
                                      },
                                      "placementVersion": {
                                        "anyOf": [
                                          {
                                            "type": "integer",
                                            "minimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          {
                                            "type": "null"
                                          }
                                        ]
                                      }
                                    },
                                    "required": [
                                      "id",
                                      "version",
                                      "inventoryItemId",
                                      "itemVersion",
                                      "placementVersion"
                                    ],
                                    "additionalProperties": false
                                  }
                                },
                                "required": [
                                  "collectionId",
                                  "slot"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "null"
                              }
                            ]
                          }
                        },
                        "required": [
                          "itemId",
                          "itemVersion",
                          "placement"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                },
                "required": [
                  "kind",
                  "item",
                  "ref"
                ],
                "additionalProperties": false
              }
            }
          },
          "required": [
            "version",
            "operationId",
            "inventoryRevision",
            "destinationCollectionId",
            "collections",
            "emptyDestinationSlots",
            "manifest",
            "slots",
            "copies"
          ],
          "additionalProperties": false
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "Success",
      "content": {
        "application/json": {
          "schema": {
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "type": "object",
            "properties": {
              "inventoryRevision": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "changed": {
                "type": "boolean",
                "const": true
              },
              "collectionId": {
                "type": "string",
                "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
              },
              "collectionVersion": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "layoutRevision": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "slotIds": {
                "maxItems": 4096,
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200
                }
              },
              "addedItemIds": {
                "maxItems": 5000,
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200
                }
              },
              "removedEmptySlotIds": {
                "maxItems": 4096,
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200
                }
              }
            },
            "required": [
              "inventoryRevision",
              "changed",
              "collectionId",
              "collectionVersion",
              "layoutRevision",
              "slotIds",
              "addedItemIds",
              "removedEmptySlotIds"
            ],
            "additionalProperties": false
          }
        }
      }
    },
    "400": {
      "description": "See the API conventions page.",
      "content": {
        "application/json": {
          "schema": {
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "type": "object",
            "properties": {
              "error": {
                "type": "object",
                "properties": {
                  "code": {
                    "type": "string"
                  },
                  "message": {
                    "type": "string"
                  },
                  "requestId": {
                    "type": "string"
                  }
                },
                "required": [
                  "code",
                  "message",
                  "requestId"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "error"
            ],
            "additionalProperties": false
          }
        }
      }
    },
    "401": {
      "description": "See the API conventions page.",
      "content": {
        "application/json": {
          "schema": {
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "type": "object",
            "properties": {
              "error": {
                "type": "object",
                "properties": {
                  "code": {
                    "type": "string"
                  },
                  "message": {
                    "type": "string"
                  },
                  "requestId": {
                    "type": "string"
                  }
                },
                "required": [
                  "code",
                  "message",
                  "requestId"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "error"
            ],
            "additionalProperties": false
          }
        }
      }
    },
    "402": {
      "description": "See the API conventions page.",
      "content": {
        "application/json": {
          "schema": {
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "type": "object",
            "properties": {
              "error": {
                "type": "object",
                "properties": {
                  "code": {
                    "type": "string"
                  },
                  "message": {
                    "type": "string"
                  },
                  "requestId": {
                    "type": "string"
                  }
                },
                "required": [
                  "code",
                  "message",
                  "requestId"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "error"
            ],
            "additionalProperties": false
          }
        }
      }
    },
    "403": {
      "description": "See the API conventions page.",
      "content": {
        "application/json": {
          "schema": {
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "type": "object",
            "properties": {
              "error": {
                "type": "object",
                "properties": {
                  "code": {
                    "type": "string"
                  },
                  "message": {
                    "type": "string"
                  },
                  "requestId": {
                    "type": "string"
                  }
                },
                "required": [
                  "code",
                  "message",
                  "requestId"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "error"
            ],
            "additionalProperties": false
          }
        }
      }
    },
    "404": {
      "description": "See the API conventions page.",
      "content": {
        "application/json": {
          "schema": {
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "type": "object",
            "properties": {
              "error": {
                "type": "object",
                "properties": {
                  "code": {
                    "type": "string"
                  },
                  "message": {
                    "type": "string"
                  },
                  "requestId": {
                    "type": "string"
                  }
                },
                "required": [
                  "code",
                  "message",
                  "requestId"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "error"
            ],
            "additionalProperties": false
          }
        }
      }
    },
    "409": {
      "description": "Only the bound terminal ledger rejection carries proof; ordinary conflicts do not.",
      "content": {
        "application/json": {
          "schema": {
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "error": {
                    "type": "object",
                    "properties": {
                      "code": {
                        "type": "string"
                      },
                      "message": {
                        "type": "string"
                      },
                      "requestId": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "code",
                      "message",
                      "requestId"
                    ],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "error"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "error": {
                    "type": "object",
                    "properties": {
                      "code": {
                        "type": "string",
                        "const": "storage_import_rejected"
                      },
                      "message": {
                        "type": "string",
                        "const": "The original import did not commit. Read current storage before explicit reconciliation."
                      },
                      "requestId": {
                        "type": "string"
                      },
                      "rejection": {
                        "type": "object",
                        "properties": {
                          "outcome": {
                            "type": "string",
                            "const": "rejected"
                          },
                          "operationId": {
                            "type": "string",
                            "minLength": 8,
                            "maxLength": 100
                          },
                          "code": {
                            "type": "string",
                            "enum": [
                              "inventory_revision_conflict",
                              "inventory_collection_conflict",
                              "arrangement_destination_conflict",
                              "import_copy_conflict"
                            ]
                          },
                          "inventoryRevision": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991
                          }
                        },
                        "required": [
                          "outcome",
                          "operationId",
                          "code",
                          "inventoryRevision"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "required": [
                      "code",
                      "message",
                      "requestId",
                      "rejection"
                    ],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "error"
                ],
                "additionalProperties": false
              }
            ]
          }
        }
      }
    },
    "413": {
      "description": "See the API conventions page.",
      "content": {
        "application/json": {
          "schema": {
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "type": "object",
            "properties": {
              "error": {
                "type": "object",
                "properties": {
                  "code": {
                    "type": "string"
                  },
                  "message": {
                    "type": "string"
                  },
                  "requestId": {
                    "type": "string"
                  }
                },
                "required": [
                  "code",
                  "message",
                  "requestId"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "error"
            ],
            "additionalProperties": false
          }
        }
      }
    },
    "422": {
      "description": "See the API conventions page.",
      "content": {
        "application/json": {
          "schema": {
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "type": "object",
            "properties": {
              "error": {
                "type": "object",
                "properties": {
                  "code": {
                    "type": "string"
                  },
                  "message": {
                    "type": "string"
                  },
                  "requestId": {
                    "type": "string"
                  }
                },
                "required": [
                  "code",
                  "message",
                  "requestId"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "error"
            ],
            "additionalProperties": false
          }
        }
      }
    },
    "429": {
      "description": "See the API conventions page.",
      "content": {
        "application/json": {
          "schema": {
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "type": "object",
            "properties": {
              "error": {
                "type": "object",
                "properties": {
                  "code": {
                    "type": "string"
                  },
                  "message": {
                    "type": "string"
                  },
                  "requestId": {
                    "type": "string"
                  }
                },
                "required": [
                  "code",
                  "message",
                  "requestId"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "error"
            ],
            "additionalProperties": false
          }
        }
      }
    },
    "503": {
      "description": "See the API conventions page.",
      "content": {
        "application/json": {
          "schema": {
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "type": "object",
            "properties": {
              "error": {
                "type": "object",
                "properties": {
                  "code": {
                    "type": "string"
                  },
                  "message": {
                    "type": "string"
                  },
                  "requestId": {
                    "type": "string"
                  }
                },
                "required": [
                  "code",
                  "message",
                  "requestId"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "error"
            ],
            "additionalProperties": false
          }
        }
      }
    }
  }
}
```