Apply storage recovery

Loading API explorer…

POST

/storage/recovery/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 exactly reviewed native version-1 recovery with confirmation, planToken and retry-stable operationId. Current authority and newer/ABA changes remain enforced. No fallback to legacy recovery.

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

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

operationId*string

Length8 <= length <= 100

planToken*string

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

confirmed*boolean

planVersion*number

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/apply' \  -H 'Content-Type: application/json' \  -d '{  "eventId": "string",  "restoreUnassignedItemIds": [    "string"  ],  "operationId": "stringst",  "planToken": "string",  "confirmed": true,  "planVersion": 1}'

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/apply' \ -H 'Content-Type: application/json' \ -d '{ "eventId": "string", "restoreUnassignedItemIds": [ "string" ], "operationId": "stringst", "planToken": "string", "confirmed": true, "planVersion": 1}'

Apply storage recovery

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