v48

latestOpenAPI 3.0.0raw.githubusercontent.com2025-12-0297180624.8 KB
File System

Delete box file/dir

Deletes a file or a directory. If target path doesn't exist, the delete will fail.

delete/boxes/{boxId}/fs

Path parameters

boxIdstring required
Example:c9bdc193-b54b-4ddb-a035-5ac0c598d32d

Box ID

Request body

workingDirstring

Working directory. If not provided, the file will be read from the box.config.workingDir directory.

pathstring required

Target path in the box. If the path does not start with '/', the file/directory will be deleted relative to the working directory. If the target path does not exist, the delete will fail.

Example request

{
  "workingDir": "/home/user/documents",
  "path": "/home/user/documents/output.txt"
}

Response

Delete file/dir

messagestring required

Success message

Example response

{
  "message": "File/Directory deleted successfully"
}