Apply storage recovery v2

Loading API explorer…

POST

/storage/recovery/v2/apply

A committed terminal rejection returns REST 409 storage_recovery_rejected or MCP isError with strict error.rejection (outcome, original operationId, code, inventoryRevision). Only recovery_plan_conflict and recovery_dependency_conflict are terminal. Accepted/rejected exact replay precedes mutable plan reconstruction but requires current authority. Preserve unknown requests; status, billing errors and cancellation are not proof. After proof, obtain a fresh complete current owner/session read and explicitly discard, or review a new preview and confirm a new operationId. MCP outputSchema describes accepted receipts only; holofolder.com/errorSchemas metadata declares errors. Apply the exact confirmed version-2 default-creation plan with explicit replacement and stable operationId. Unsupported dependencies and conflicts reject atomically; no legacy fallback.

Required permissions: collection:read, collection:write, binders:write. MCP tool: apply_storage_recovery_v2.

Authorization

apiKey

headerAuthorizationBearer <Holo Folder personal API key>

Request Body

application/json

body

eventId*string

Match^[1-9]\d{0,18}$

restoreUnassignedItemIds*array<>

Itemsitems <= 16384

planVersion*number

replacementDefaultCollectionId*string

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

inventoryRevision*integer

Range0 <= value <= 9007199254740991

collections*array<>

Items1 <= items <= 1

operationId*string

Length8 <= length <= 100

planToken*string

Match^[a-f0-9]{64}$

confirmed*boolean

Response Body

Success

application/json

response

inventoryRevision*integer

Range0 <= value <= 9007199254740991

eventId*string

Match^[1-9]\d{0,18}$

recoveredEventId*string

Match^[1-9]\d{0,18}$

collections*array<>

Itemsitems <= 4096

Example Request

curl -X POST 'https://app.holofolder.com/app/api/v1/storage/recovery/v2/apply' \  -H 'Content-Type: application/json' \  -d '{  "eventId": "string",  "restoreUnassignedItemIds": [    "string"  ],  "planVersion": 2,  "replacementDefaultCollectionId": "string",  "inventoryRevision": 0,  "collections": [    {      "collectionId": "string",      "version": 0,      "layoutRevision": 0    }  ],  "operationId": "stringst",  "planToken": "string",  "confirmed": true}'

Example ResponseSchema

{  "inventoryRevision": 0,  "eventId": "string",  "recoveredEventId": "string",  "collections": [    {      "collectionId": "string",      "version": 0,      "layoutRevision": 0    }  ]}

Loading API explorer…

curl -X POST 'https://app.holofolder.com/app/api/v1/storage/recovery/v2/apply' \ -H 'Content-Type: application/json' \ -d '{ "eventId": "string", "restoreUnassignedItemIds": [ "string" ], "planVersion": 2, "replacementDefaultCollectionId": "string", "inventoryRevision": 0, "collections": [ { "collectionId": "string", "version": 0, "layoutRevision": 0 } ], "operationId": "stringst", "planToken": "string", "confirmed": true}'

Apply storage recovery v2

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