Edit Folder API - v3

To rename a folder via API.

Request URL:

https://people.zoho.com/people/api/v3/files/folder/edit

Scope:

ZOHOPEOPLE.files.ALL

Request Type:

PUT

Request Parameters:

Parameter NameValues allowedMandatoryDescription
folder_idLongYesFolder ID to edit
parent_folder_idLongNoParent folder ID (if moving folder)
folder_nameTextYesNew name of the folder
latitudeText NoRequest location latitude
longitudeTextNoRequest location longitude

Threshold Limit: 30 requests | Lock period: 5 minutes

Threshold Limit - Number of API calls allowed within a minute.
Lock Period - Wait time before consecutive API requests.

Sample Request:

Copiedhttps://people.zoho.com/api/v3/files/folder/edit?folder_name=Office Policy&folder_id=******000003034011

Requests

CopiedOkHttpClient client = new OkHttpClient().newBuilder().build();

RequestBody requestBody = new MultipartBody.Builder().setType(MultipartBody.FORM).build();

Request request = new Request.Builder()
    .url("https://people.zoho.com/api/v3/files/folder/edit"
        + "?folder_name=Office Policy"
        + "&folder_id=******000003034011")
    .method("POST", requestBody)
    .build();

Response response = client.newCall(request).execute();
Copiedcurl -X POST "https://people.zoho.com/api/v3/files/folder/edit" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
        "folder_id": "******000003034011",
        "folder_name": "Office Policy"
      }'

Sample Response:

Copied{
 "data": {
 "result": {
 "parent_folder_id": "null",
 "folder_name": "Office Policy",
 "folder_id": "******000003034011"
 }
 },
 "message": "Folder modified successfully",
 "status": "success"
}