Skip to main content
POST
/
platform
/
recovery
/
files
/
{fileId}
Recover a file
curl --request POST \
  --url https://api.rootkey.ai/api-v1/platform/recovery/files/{fileId} \
  --header 'x-api-key: <api-key>'
{
  "recoveryId": "rop_03l1b0m4o6p8r0s2t4u6v8x0",
  "type": "file",
  "assetId": "rec_01j9z8k2m4n6p8q0r2s4t6v8",
  "status": "completed",
  "fileId": "f_01j9z8k2m4n6p8q0r2s4t6v8",
  "fileName": "audit-report-q3-2025.pdf",
  "vaultAddress": "0x1234567890abcdef1234567890abcdef12345678",
  "restoredAt": "2025-10-05T08:00:00Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.rootkey.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
fileId
string
required

The ID of the file to recover

Example:

"rec_01j9z8k2m4n6p8q0r2s4t6v8"

Response

File recovered successfully

​
recoveryId
string
required

Unique ID of this recovery operation

Example:

"rop_01j9z8k2m4n6p8q0r2s4t6v8"

​
type
enum<string>
required

Asset type that was recovered

Available options:
vault,
file
​
assetId
string
required

ID of the recoverable item that was restored

​
status
enum<string>
required

Current status of the recovery operation

Available options:
pending,
completed,
failed
​
fileId
string | null

Restored file ID - only present for file recoveries

​
fileName
string | null

Restored file name - only present for file recoveries

​
vaultAddress
string | null

Vault blockchain address

​
restoredAt
string<date-time>

Timestamp when the asset was restored