Skip to main content
POST
/
boxes
/
{boxId}
/
fs
/
rename
JavaScript
import GboxSDK from "gbox-sdk";

const gboxSDK = new GboxSDK({
  apiKey: process.env["GBOX_API_KEY"] // This is the default and can be omitted
});

async function main() {
  const box = await gboxSDK.create({ type: "linux" });
  // prepare: write a file
  await box.fs.write({
    path: "/tmp/example.txt",
    content: "Hello, world!",
  });

  // Rename a file
  const renamedFile = await box.fs.rename({
    oldPath: "/tmp/example.txt",
    newPath: "/tmp/example2.txt",
  });

  console.log("File renamed successfully:", renamedFile.path);
}

main();
{
  "type": "file",
  "name": "example.txt",
  "path": "/path/to/example.txt",
  "size": "10MB",
  "mode": "755",
  "lastModified": "2021-01-01T00:00:00Z"
}

Authorizations

Authorization
string
header
required

Enter your API Key in the format: Bearer <token>. Get it from https://gbox.ai

Path Parameters

boxId
string
required

Box ID

Example:

"c9bdc193-b54b-4ddb-a035-5ac0c598d32d"

Body

application/json

Request parameters for renaming a file/directory

oldPath
string
required

Old path in the box. If the path does not start with '/', the file/directory will be renamed relative to the working directory. If the oldPath does not exist, the rename will fail.

Example:

"/home/user/documents/output.txt"

newPath
string
required

New path in the box. If the path does not start with '/', the file/directory will be renamed relative to the working directory. If the newPath already exists, the rename will fail.

Example:

"/home/user/documents/new-name.txt"

workingDir
string

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

Example:

"/home/user/documents"

Response

Rename file

  • File
  • Directory

File system file representation

type
enum<string>
required

File type indicator

Available options:
file
name
string
required

Name of the file

Example:

"example.txt"

path
string
required

Full path to the file in the box

Example:

"/path/to/example.txt"

size
string
required

Size of the file

Example:

"10MB"

mode
string
required

File metadata

Example:

"755"

lastModified
string<date-time>
required

Last modified time of the file

Example:

"2021-01-01T00:00:00Z"

I