# Preview storage preset

Source: https://holofolder.com/app/docs/reference/collection/preview-storage-preset

POST https://app.holofolder.com/app/api/v1/storage/presets/preview

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

```json
{
  "operationId": "preview_storage_preset",
  "summary": "Preview storage preset",
  "description": "Preview a detached ordered copied manifest without saving, assigning ownership, creating wants or allocating operation/collection/slot IDs. Use version 1, with speciesIds only for selected-species or printings only for selected-printings. Exact catalog language and requested finish evidence must be available; incomplete/ambiguous evidence fails the whole preview. Set/master-set scopes are unsupported. Manifest entries are preset entry IDs, not slot IDs. Not complete planner or queue ACK evidence; no autosync.\n\nRequired permissions: `catalog:read`, `binders:read`. MCP tool: `preview_storage_preset`.",
  "tags": [
    "Collection"
  ],
  "security": [
    {
      "apiKey": []
    }
  ],
  "parameters": [],
  "x-max-body-bytes": 65536,
  "requestBody": {
    "required": true,
    "content": {
      "application/json": {
        "schema": {
          "$schema": "https://json-schema.org/draft/2020-12/schema",
          "type": "object",
          "properties": {
            "presetId": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            },
            "version": {
              "type": "string",
              "const": "1"
            },
            "speciesIds": {
              "maxItems": 1025,
              "type": "array",
              "items": {
                "type": "integer",
                "minimum": 1,
                "maximum": 1025
              }
            },
            "printings": {
              "maxItems": 100,
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "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": [
                  "cardId",
                  "language"
                ],
                "additionalProperties": false
              }
            }
          },
          "required": [
            "presetId",
            "version"
          ],
          "additionalProperties": false
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "Success",
      "content": {
        "application/json": {
          "schema": {
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "type": "object",
            "properties": {
              "projection": {
                "type": "string",
                "const": "copied-preset-preview-v1"
              },
              "completeSnapshot": {
                "type": "boolean",
                "const": false
              },
              "preset": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200
                  },
                  "version": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200
                  }
                },
                "required": [
                  "id",
                  "version"
                ],
                "additionalProperties": false
              },
              "manifest": {
                "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": 1025,
                    "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": 1025
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "pokemonId"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "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"
                                      ]
                                    },
                                    "kind": {
                                      "type": "string",
                                      "const": "card"
                                    }
                                  },
                                  "required": [
                                    "cardId",
                                    "language",
                                    "kind"
                                  ],
                                  "additionalProperties": false
                                }
                              ]
                            },
                            {
                              "type": "null"
                            }
                          ]
                        }
                      },
                      "required": [
                        "id",
                        "target"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "source",
                  "name",
                  "entries"
                ],
                "additionalProperties": false
              },
              "scope": {
                "type": "object",
                "properties": {
                  "kind": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200
                  },
                  "speciesIds": {
                    "type": "array",
                    "items": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    }
                  },
                  "printings": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "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": [
                        "cardId",
                        "language"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "kind"
                ],
                "additionalProperties": false
              },
              "targetCount": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "freeSlotCount": {
                "type": "number",
                "const": 0
              },
              "ownershipCreated": {
                "type": "boolean",
                "const": false
              },
              "exclusions": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "unknowns": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "required": [
              "projection",
              "completeSnapshot",
              "preset",
              "manifest",
              "scope",
              "targetCount",
              "freeSlotCount",
              "ownershipCreated",
              "exclusions",
              "unknowns"
            ],
            "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": "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
          }
        }
      }
    },
    "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
          }
        }
      }
    }
  }
}
```