Of the 6 File methods, browser sessions serve 0, phone sessions 0 and computer sessions 6. A method marked not served answers StrategyUnavailable on that kind of session; check the handshake’s capabilities before relying on one.

File.read

Browser: not served Phone: not served Computer: served A file’s content, base64, at most x-dcp-computer-limits.fileMaxBytes. Computer sessions only.
{"id": 1, "method": "File.read", "params": {"path": "%USERPROFILE%\\Documents\\notes.txt"}}
ParamTypeRequiredDescription
pathstringYesAbsolute, may use environment variables (%USERPROFILE%); a relative path is taken from the user’s home folder.
idempotencyKeystringNoMakes a re-send after a reconnect safe: a repeated key returns the recorded response without acting again. See Idempotency keys.
Result
FieldTypeDescription
pathstring
contentBase64string
sizeinteger

File.write

Browser: not served Phone: not served Computer: served Write a file from base64 content, creating its folders, replacing it unless append. C:\ax is read-only apart from C:\ax\downloads. Computer sessions only.
{"id": 1, "method": "File.write", "params": {"path": "%USERPROFILE%\\Documents\\notes.txt", "contentBase64": "aGVsbG8="}}
ParamTypeRequiredDescription
pathstringYes
contentBase64stringYes
appendbooleanNo
idempotencyKeystringNoMakes a re-send after a reconnect safe: a repeated key returns the recorded response without acting again. See Idempotency keys.
Result
FieldTypeDescription
namestring
pathstring
isDirboolean
sizeinteger
modifiedMsinteger

File.list

Browser: not served Phone: not served Computer: served A folder’s entries, at most 10000. Computer sessions only.
{"id": 1, "method": "File.list", "params": {"path": "%USERPROFILE%\\Documents\\notes.txt"}}
ParamTypeRequiredDescription
pathstringYesAbsolute, may use environment variables (%USERPROFILE%); a relative path is taken from the user’s home folder.
idempotencyKeystringNoMakes a re-send after a reconnect safe: a repeated key returns the recorded response without acting again. See Idempotency keys.
Result
FieldTypeDescription
pathstring
entriesFileInfo[]
truncatedboolean

File.stat

Browser: not served Phone: not served Computer: served One file’s or folder’s details. Computer sessions only.
{"id": 1, "method": "File.stat", "params": {"path": "%USERPROFILE%\\Documents\\notes.txt"}}
ParamTypeRequiredDescription
pathstringYesAbsolute, may use environment variables (%USERPROFILE%); a relative path is taken from the user’s home folder.
idempotencyKeystringNoMakes a re-send after a reconnect safe: a repeated key returns the recorded response without acting again. See Idempotency keys.
Result
FieldTypeDescription
namestring
pathstring
isDirboolean
sizeinteger
modifiedMsinteger

File.mkdir

Browser: not served Phone: not served Computer: served Create a folder and its parents. Computer sessions only.
{"id": 1, "method": "File.mkdir", "params": {"path": "%USERPROFILE%\\Documents\\notes.txt"}}
ParamTypeRequiredDescription
pathstringYesAbsolute, may use environment variables (%USERPROFILE%); a relative path is taken from the user’s home folder.
idempotencyKeystringNoMakes a re-send after a reconnect safe: a repeated key returns the recorded response without acting again. See Idempotency keys.
Result
FieldTypeDescription
namestring
pathstring
isDirboolean
sizeinteger
modifiedMsinteger

File.delete

Browser: not served Phone: not served Computer: served Delete a file, or a folder (recursive for one that isn’t empty). Computer sessions only.
{"id": 1, "method": "File.delete", "params": {"path": "%USERPROFILE%\\Documents\\notes.txt"}}
ParamTypeRequiredDescription
pathstringYes
recursivebooleanNo
idempotencyKeystringNoMakes a re-send after a reconnect safe: a repeated key returns the recorded response without acting again. See Idempotency keys.
Result: an empty object {}.