Storage

Move a stored file into or out of a folder

Requires scope files:write. Sets or clears the folder recorded for every account entry with this root.

PATCH/api/v1/files/{root}Try it

iNote

Requires a key with the files:write scope, sent as Authorization: Bearer <api-key>. Keys missing the scope are rejected with 403 — see Authentication.

Path parameters

Name	In	Type	Description
rootrequired	path	string	The Merkle root (content id) of the stored file.

Body

application/json FileMoveRequestrequired

Example body

{
  "folder": "string"
}

Errors

Code	Meaning
400	Body is not a JSON object, or folder is not a string or null.
401	Invalid or missing API key.
403	The API key lacks the required scope for this operation.
404	The root is not stored under this account.

cURL

curl -X PATCH https://gateway.kepto.xyz/api/v1/files/<root> \
  -H "Authorization: Bearer <api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "folder": "string"
  }'

200 · application/json

{
  "moved": true,
  "root": "string",
  "folder": "string"
}