Remove Folder Customization

Open in ChatGPT Open in ChatGPT to ask questions about this page
Open in Claude Open in Claude to ask questions about this page
Copy as MarkdownCopy this page as markdown to use with AI assistants
View as Markdown Open this page as markdown in a new tab

This API allows you to remove folder customization in a Team Folder.

Endpoints

OAuth Scope

WorkDrive.files.UPDATECopied!

Request Example

cURL
cURL
Deluge
Copied!
curl --request PATCH \
  --url https://www.zohoapis.com/workdrive/api/v1/files/{resource_id} \
  --header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
  --header 'content-type: application/vnd.api+json' \
  --data '{"data":{"attributes":{"customized":false},"type":"files"}}'

Path Parameters

resource_idstring(Required)

The unique ID of the folder.

Request Body

application/vnd.api+json
dataJSON Object(Required)
Hide Sub-Attributes
attributesJSON Object(Required)
Hide Sub-Attributes
customizedboolean(Required)

Set to "false" to remove folder customization.

typestring(Required)

The JSON:API resource type. Always "files".

Allowed Values :
Show Values
filesCopied!
Copied!Copy all as JSON Array

Body Parameters

Copied!
  {
    "data": {
      "attributes": {
        "customized": false
      },
      "type": "files"
    }
  }
                
Show full

Response Example

R004

F7003

F7003

F973

F974

F972

F970

F970

F971

F000

200
200
400
401
403
412
422
500
Copied!
  {
    "data": {
      "id": "cjrrr11cfe79441684ada83b862c32f3696a9",
      "type": "files",
      "attributes": {
        "active_workflow_instance": {},
        "modified_by_zuid": "65817146",
        "is_locked": false,
        "conv_engine_type": 0,
        "is_fillable_resource": false,
        "is_published": false,
        "destination_id": "ly9zm0170fb40015f4e2297a144e2b68cfa68",
        "storage_info": {
          "size": "0 bytes",
          "storage_used": "0 bytes",
          "files_count": 0,
          "folders_count": 0,
          "size_in_bytes": 0,
          "storage_used_in_bytes": 0,
          "storage_used_by_team_folders_in_bytes": 0,
          "size_used_by_team_folders_in_bytes": 0,
          "storage_used_by_workdrive_in_bytes": 0,
          "storage_used_by_app_in_bytes": 0
        },
        "type": "folder",
        "created_time_i18": "Mar 31, 3:26 PM",
        "associated_data_templates": [],
        "modified_time_in_millisecond": 1743414998982,
        "status_change_time": "Mar 31, 3:26 PM",
        "role_id": 3,
        "download_url": "https://www.zohoapis.com/workdrive/download/cjrrr11cfe79441684ada83b862c32f3696a9",
        "comment_badge_count": 0,
        "is_app_associated": false,
        "created_time": "Mar 31, 3:26 PM",
        "lock_status": 2,
        "is_folder": true,
        "is_parent_customized": false,
        "resource_type": 1001,
        "is_email_in_upload": false,
        "res_scope": 0,
        "display_attr_name": "Collection",
        "created_by": "Zylker Creation",
        "display_html_name": "Collection",
        "labels": [],
        "org_id": "ly9zmae16b43c258f458a9a57ac02c4f8d763",
        "parent_id": "ly9zm0170fb40015f4e2297a144e2b68cfa68",
        "name": "Collection",
        "status_change_time_in_millisecond": 1743414998982,
        "permalink": "https://www.zohoapis.com/workdrive/folder/cjrrr11cfe79441684ada83b862c32f3696a9",
        "favorite": false,
        "new_badge_count": 0,
        "status": 1,
        "modified_time_i18": "Mar 31, 3:26 PM",
        "extn": "",
        "customized": false,
        "view_pref": {
          "sort_by": "last_modified",
          "sort_order": "desc",
          "filtered_by": "all",
          "layout": "list"
        },
        "shortcut_link": "",
        "status_change_time_i18": "Mar 31, 3:26 PM",
        "description": "",
        "uploaded_time_in_millisecond": 1743414998985,
        "thumbnail_url": "",
        "title": "",
        "files_view_pref": {
          "sort_by": "last_modified",
          "sort_order": "desc",
          "filtered_by": "all",
          "layout": "list"
        },
        "modified_time": "Mar 31, 3:26 PM",
        "library_id": "ly9zm0170fb40015f4e2297a144e2b68cfa68",
        "icon_class": "folder",
        "created_time_in_millisecond": 1743414998982,
        "owner": "747937818",
        "creator": "747938014",
        "is_collection_associated": false,
        "capabilities": {
          "can_read": true,
          "can_share": true,
          "can_remove_share": true,
          "can_delete": false,
          "can_edit": true,
          "can_partial_read": false,
          "can_create_files": true,
          "can_upload_files": true,
          "can_trash": false,
          "can_rename": true,
          "can_restore": false,
          "can_copy": true,
          "can_move": false,
          "can_zip": true,
          "can_download": true,
          "can_emailattach": true,
          "can_publish": true,
          "can_create_task": false,
          "can_share_support": true,
          "can_label": true,
          "can_delist_file": true,
          "can_associate_data_template": true,
          "can_mandate_data_template": false,
          "can_favorite": true,
          "can_customize": true,
          "can_configure_workflow": true,
          "is_edit_restricted_via_workflow": false,
          "can_show_activity_tab": true,
          "can_show_access_stats_tab": true,
          "can_trash_files": false,
          "can_open_with_addons": false,
          "has_app_permission_alone": false
        },
        "uploaded_time_i18": "Mar 31, 3:26 PM",
        "is_external_upload": false,
        "watch_preference": {
          "watch": false,
          "notifyemail": false,
          "notifybell": false
        },
        "opened_time_in_millisecond": 0,
        "edit_badge_count": 0,
        "share_data": [],
        "data_template_id_to_mandate": "",
        "uploaded_time": "Mar 31, 3:26 PM",
        "has_folders": false,
        "service_type": "upload",
        "display_url_name": "Collection",
        "is_unread": false,
        "modified_by": "Zylker Creation",
        "creator_avatar_url": "https://contacts.zoho.com/file?t=user&ID=747938014&fs=thumb&nps=404",
        "is_index_layout_file": false,
        "embed_props": {}
      },
      "relationships": {
        "folders": {
          "links": {
            "self": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/relationships/folders",
            "related": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/folders"
          }
        },
        "filequery": {
          "links": {
            "self": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/relationships/filequery",
            "related": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/filequery"
          }
        },
        "dlpsensitivecontentidentifiers": {
          "links": {
            "self": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/relationships/dlpsensitivecontentidentifiers",
            "related": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/dlpsensitivecontentidentifiers"
          }
        },
        "records": {
          "links": {
            "self": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/relationships/records",
            "related": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/records"
          }
        },
        "instances": {
          "links": {
            "self": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/relationships/instances",
            "related": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/instances"
          }
        },
        "unzip": {
          "links": {
            "self": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/relationships/unzip",
            "related": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/unzip"
          }
        },
        "performtransition": {
          "links": {
            "self": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/relationships/performtransition",
            "related": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/performtransition"
          }
        },
        "accesschartdata": {
          "links": {
            "self": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/relationships/accesschartdata",
            "related": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/accesschartdata"
          }
        },
        "resourceproperty": {
          "links": {
            "self": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/relationships/resourceproperty",
            "related": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/resourceproperty"
          }
        },
        "shortcut": {
          "links": {
            "self": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/relationships/shortcut",
            "related": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/shortcut"
          }
        },
        "importfile": {
          "links": {
            "self": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/relationships/importfile",
            "related": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/importfile"
          }
        },
        "permissions": {
          "links": {
            "self": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/relationships/permissions",
            "related": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/permissions"
          }
        },
        "saveastemplate": {
          "links": {
            "self": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/relationships/saveastemplate",
            "related": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/saveastemplate"
          }
        },
        "links": {
          "links": {
            "self": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/relationships/links",
            "related": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/links"
          }
        },
        "copy": {
          "links": {
            "self": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/relationships/copy",
            "related": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/copy"
          }
        },
        "previewzip": {
          "links": {
            "self": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/relationships/previewzip",
            "related": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/previewzip"
          }
        },
        "tasks": {
          "links": {
            "self": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/relationships/tasks",
            "related": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/tasks"
          }
        },
        "custommetadata": {
          "links": {
            "self": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/relationships/custommetadata",
            "related": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/custommetadata"
          }
        },
        "deletedversions": {
          "links": {
            "self": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/relationships/deletedversions",
            "related": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/deletedversions"
          }
        },
        "comments": {
          "links": {
            "self": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/relationships/comments",
            "related": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/comments"
          }
        },
        "previewinfo": {
          "links": {
            "self": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/relationships/previewinfo",
            "related": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/previewinfo"
          }
        },
        "approvedversions": {
          "links": {
            "self": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/relationships/approvedversions",
            "related": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/approvedversions"
          }
        },
        "publiclink": {
          "links": {
            "self": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/relationships/publiclink",
            "related": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/publiclink"
          }
        },
        "parentfolders": {
          "links": {
            "self": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/relationships/parentfolders",
            "related": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/parentfolders"
          }
        },
        "versions": {
          "links": {
            "self": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/relationships/versions",
            "related": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/versions"
          }
        },
        "supportshare": {
          "links": {
            "self": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/relationships/supportshare",
            "related": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/supportshare"
          }
        },
        "startjourney": {
          "links": {
            "self": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/relationships/startjourney",
            "related": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/startjourney"
          }
        },
        "recordsuggestions": {
          "links": {
            "self": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/relationships/recordsuggestions",
            "related": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/recordsuggestions"
          }
        },
        "timeline": {
          "links": {
            "self": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/relationships/timeline",
            "related": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/timeline"
          }
        },
        "files": {
          "links": {
            "self": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/relationships/files",
            "related": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/files"
          }
        },
        "accessdata": {
          "links": {
            "self": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/relationships/accessdata",
            "related": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/accessdata"
          }
        },
        "dlppolicy": {
          "links": {
            "self": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/relationships/dlppolicy",
            "related": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/dlppolicy"
          }
        },
        "breadcrumbs": {
          "links": {
            "self": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/relationships/breadcrumbs",
            "related": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/breadcrumbs"
          }
        },
        "entity": {
          "links": {
            "self": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/relationships/entity",
            "related": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/entity"
          }
        },
        "statistics": {
          "links": {
            "self": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/relationships/statistics",
            "related": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/statistics"
          }
        },
        "appdata": {
          "links": {
            "self": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/relationships/appdata",
            "related": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9/appdata"
          }
        }
      },
      "links": {
        "self": "https://www.zohoapis.com/workdrive/api/v1/files/cjrrr11cfe79441684ada83b862c32f3696a9"
      }
    }
  }
                
  {
    "errors": [
      {
        "id": "R004",
        "title": "Invalid resourceId"
      }
    ]
  }
                
  {
    "errors": [
      {
        "id": "F7003",
        "title": "Invalid OAuth token"
      }
    ]
  }
                
  {
    "errors": [
      {
        "id": "F973",
        "title": "You don't have sufficient permission to customize a resource"
      }
    ]
  }
                
  {
    "errors": [
      {
        "id": "F974",
        "title": "The resource customization limit for the team folder has been reached"
      }
    ]
  }
                
  {
    "errors": [
      {
        "id": "F972",
        "title": "Customization is not allowed for the resource"
      }
    ]
  }
                
  {
    "errors": [
      {
        "id": "F970",
        "title": "The resource customization can be done only once."
      }
    ]
  }
                
  {
    "errors": [
      {
        "id": "F971",
        "title": "Customization removal is only possible for customized resources."
      }
    ]
  }
                
  {
    "errors": [
      {
        "id": "F000",
        "title": "General exception"
      }
    ]
  }
                
Show full