Create storage collection

Loading API explorer…

POST

/storage/collections

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. Atomically create native storage from an ordered copied manifest, never a legacy create-then-edit. Migration 101 additionally accepts manifest.setScope, the exact reviewed language, verified finishes, promos, exclusions, coverage warnings and capture time. This is an independent copied initial list; goals remain editable and free slots can be appended. Catalog eligibility is checked at creation, not enforced on later edits. Preserve collection/slot/operation IDs across retries. Empty goals and spacers create no ownership or wants; recoverySupported remains conservative false.

Required permissions: collection:write, binders:write. MCP tool: create_storage_collection.

Authorization

apiKey

headerAuthorizationBearer <Holo Folder personal API key>

Request Body

application/json

body

version*number

operationId*string

Length8 <= length <= 100

inventoryRevision*integer

Range0 <= value <= 9007199254740991

collectionId*string

Match^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

name*string

Length1 <= length <= 40

kind*string

Value in"binder""slab""custom"

defaultPresentation*string

Value in"binder""slabs""list"

location*|null

grid*|null

manifest*

slotIds*array<>

Itemsitems <= 4096

Response Body

Success

application/json

response

inventoryRevision*integer

Range0 <= value <= 9007199254740991

changed*boolean

collectionId*string

Match^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

collectionVersion*integer

Range0 <= value <= 9007199254740991

layoutRevision*integer

Range0 <= value <= 9007199254740991

slotIds*array<>

Itemsitems <= 4096

recoverySupported*boolean

Example Request

curl -X POST 'https://app.holofolder.com/app/api/v1/storage/collections' \  -H 'Content-Type: application/json' \  -d '{  "version": 1,  "operationId": "stringst",  "inventoryRevision": 0,  "collectionId": "string",  "name": "string",  "kind": "binder",  "defaultPresentation": "binder",  "location": "string",  "grid": {    "rows": 1,    "cols": 1  },  "manifest": {    "source": {      "id": "string",      "version": "string"    },    "name": "string",    "entries": [      {        "id": "string",        "target": {          "kind": "pokemon",          "pokemonId": 1        }      }    ]  },  "slotIds": [    "string"  ]}'

Example ResponseSchema

{  "inventoryRevision": 0,  "changed": true,  "collectionId": "string",  "collectionVersion": 0,  "layoutRevision": 0,  "slotIds": [    "string"  ],  "recoverySupported": false}

Loading API explorer…

curl -X POST 'https://app.holofolder.com/app/api/v1/storage/collections' \ -H 'Content-Type: application/json' \ -d '{ "version": 1, "operationId": "stringst", "inventoryRevision": 0, "collectionId": "string", "name": "string", "kind": "binder", "defaultPresentation": "binder", "location": "string", "grid": { "rows": 1, "cols": 1 }, "manifest": { "source": { "id": "string", "version": "string" }, "name": "string", "entries": [ { "id": "string", "target": { "kind": "pokemon", "pokemonId": 1 } } ] }, "slotIds": [ "string" ]}'

Create storage collection

AuthorizationCopy Anchor Link

Request BodyCopy Anchor Link

Response BodyCopy Anchor Link

AuthorizationCopy Anchor Link

Request BodyCopy Anchor Link

Response BodyCopy Anchor Link

Authorization

Request Body

Response Body

Authorization

Request Body

Response Body