Rename Folder

POST /v1/folders/:folderId/rename

Updated Mar 6, 2026· 3 min read

Rename an existing folder without changing its location in the folder hierarchy. Use this API when you want to update the folder name while preserving the same folder ID, parent folder, and library context.

Path parameters

Parameter		Description
`folderId` any	required	Folder id

Query parameters

Parameter		Description
`library` string	optional	One of sharepoint, msteams, google, onedrive, box, dropbox, cloudfiles, s3, azure, hubspot, azurefiles, sftp
`driveId` string	optional	Drive id. Required when library is sharepoint or msteams.

Header parameters

Parameter		Description
`Authorization` string	optional	Replace the API_Key placeholder with your actual API key.

Request body

{
  "name": "CloudFiles API Request 1"
}

Example request

curl --request POST \
     --url 'https://api.cloudfiles.io/v1/folders/:folderId/rename?library=string&driveId=string' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'authorization: Bearer API_Key' \
     --data '"{\n    \"name\" : \"CloudFiles API Request 1\"\n}"'

var myHeaders = new Headers();
myHeaders.append("accept", "application/json");
myHeaders.append("content-type", "application/json");
myHeaders.append("authorization", "Bearer API_Key");

var raw = JSON.stringify("{\n    \"name\" : \"CloudFiles API Request 1\"\n}");

var requestOptions = {
   method: 'POST',
   headers: myHeaders,
   body: raw,
   redirect: 'follow'
};

fetch("https://api.cloudfiles.io/v1/folders/:folderId/rename?library=string&driveId=string", requestOptions)
   .then(response => response.text())
   .then(result => console.log(result))
   .catch(error => console.log('error', error));

require "uri"
require "json"
require "net/http"

url = URI("https://api.cloudfiles.io/v1/folders/:folderId/rename?library=string&driveId=string")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Post.new(url)
request["accept"] = "application/json"
request["content-type"] = "application/json"
request["authorization"] = "Bearer API_Key"
request.body = JSON.dump("{\n    \"name\" : \"CloudFiles API Request 1\"\n}")

response = https.request(request)
puts response.read_body

import requests
import json

url = "https://api.cloudfiles.io/v1/folders/:folderId/rename?library=string&driveId=string"

payload = json.dumps("{\n    \"name\" : \"CloudFiles API Request 1\"\n}")
headers = {
   'accept': 'application/json',
   'content-type': 'application/json',
   'authorization': 'Bearer API_Key'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

Create Folder

Get Folder Children