Get Suggested Files
This API returns up to 50 recommended files for a user based on activity patterns within their workspace and collaboration network.
File recommendations are generated using:
- The user's recent and long-term access behavior.
- Recent activity from teammates and collaborators within the shared work community.
Note:
This API is currently in beta and is available to users on all paid plans (Starter, Team, and Business), as well as Zoho Workplace and Zoho One bundles.
Endpoints
OAuth Scope
WorkDrive.files.READCopied!
curl --request GET \
--url https://www.zohoapis.com/workdrive/api/v1/users/{team_member_id}/suggestedfiles \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52'Path Parameters
team_member_idstring(Required)
The unique ID of the team member for whom file suggestions are to be retrieved.
Query Parameters
Note:
Query parameter name should be URL encoded with UTF-8 Charset. For more info, refer here
filter[reason]string(Optional)
Filters suggestions based on how files were accessed. user_accessed: Files recently accessed by the user. community_accessed: Files accessed by the user's team or collaborators. all: Files accessed across the entire organization.
Allowed Values :
Show Values ▾
user_accessedCopied!
community_accessedCopied!
allCopied!
Copy all as JSON Array
{
"data": [
{
"id": "5jvqw0ccf2d470af54c86866b368ea417a1e0",
"type": "files",
"attributes": {
"modified_by_zuid": "60029536924",
"is_locked": false,
"conv_engine_type": 0,
"is_fillable_resource": false,
"is_published": false,
"collab_id": "1798890573648266732",
"storage_info": {
"size": "0 byte",
"storage_used": "0 byte",
"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": "writer",
"spam_info": {
"is_res_spam": false
},
"created_time_i18": "Mar 24, 2023, 1:53 PM",
"associated_data_templates": [],
"is_marked_final": false,
"modified_time_in_millisecond": 1688713025595,
"status_change_time": "Jul 7, 2023, 12:27 PM",
"role_id": 0,
"download_url": "https://download-accl.zoho.in/v1/workdrive/download/5jvqw0ccf2d470af54c86866b368ea417a1e0",
"comment_badge_count": 0,
"is_app_associated": false,
"created_time": "Mar 24, 2023, 1:53 PM",
"lock_status": 2,
"is_folder": false,
"is_parent_customized": false,
"resource_type": 2001,
"is_email_in_upload": false,
"res_scope": 0,
"display_attr_name": "Chunk File Upload (CFU) - APIs",
"created_by": "Avinash R",
"display_html_name": "Chunk File Upload (CFU) - APIs",
"labels": [],
"name": "Chunk File Upload (CFU) - APIs",
"status_change_time_in_millisecond": 1688713025595,
"permalink": "https://writer.zoho.in/writer/open/5jvqw0ccf2d470af54c86866b368ea417a1e0",
"favorite": false,
"new_badge_count": 0,
"is_camera_upload_folder": false,
"status": 1,
"modified_time_i18": "Jul 7, 2023, 12:27 PM",
"extn": "zwriter",
"suggested_time": "Feb 10, 12:33 PM",
"customized": false,
"shortcut_link": "",
"status_change_time_i18": "Jul 7, 2023, 12:27 PM",
"description": "",
"uploaded_time_in_millisecond": 1679646230846,
"thumbnail_url": "https://previewengine-accl.zoho.in/thumbnail/WD/5jvqw0ccf2d470af54c86866b368ea417a1e0",
"title": "",
"modified_time": "Jul 7, 2023, 12:27 PM",
"icon_class": "writer",
"created_time_in_millisecond": 1679646230846,
"owner": "60040420614",
"creator": "60029536924",
"url_link": "",
"uploaded_time_i18": "Mar 24, 2023, 1:53 PM",
"suggested_reason": 104,
"is_external_upload": false,
"watch_preference": {
"watch": false,
"notifyemail": false,
"notifybell": false
},
"opened_time_in_millisecond": 0,
"edit_badge_count": 0,
"share_data": [],
"uploaded_time": "Mar 24, 2023, 1:53 PM",
"has_folders": false,
"service_type": "zw",
"display_url_name": "Chunk+File+Upload+%28CFU%29+-+APIs",
"is_unread": false,
"modified_by": "Avinash R",
"creator_avatar_url": "https://contacts.zoho.in/file?t=user&ID=60029536924&fs=thumb&nps=404",
"suggested_time_in_ms": 1770707007017,
"is_index_layout_file": false,
"embed_props": {}
},
"relationships": {
"permissions": {
"links": {
"self": "https://www.zohoapis.com/workdrive/api/v1/files/5jvqw0ccf2d470af54c86866b368ea417a1e0/relationships/permissions",
"related": "https://www.zohoapis.com/workdrive/api/v1/files/5jvqw0ccf2d470af54c86866b368ea417a1e0/permissions"
}
},
"saveastemplate": {
"links": {
"self": "https://www.zohoapis.com/workdrive/api/v1/files/5jvqw0ccf2d470af54c86866b368ea417a1e0/relationships/saveastemplate",
"related": "https://www.zohoapis.com/workdrive/api/v1/files/5jvqw0ccf2d470af54c86866b368ea417a1e0/saveastemplate"
}
},
"links": {
"links": {
"self": "https://www.zohoapis.com/workdrive/api/v1/files/5jvqw0ccf2d470af54c86866b368ea417a1e0/relationships/links",
"related": "https://www.zohoapis.com/workdrive/api/v1/files/5jvqw0ccf2d470af54c86866b368ea417a1e0/links"
}
},
"copy": {
"links": {
"self": "https://www.zohoapis.com/workdrive/api/v1/files/5jvqw0ccf2d470af54c86866b368ea417a1e0/relationships/copy",
"related": "https://www.zohoapis.com/workdrive/api/v1/files/5jvqw0ccf2d470af54c86866b368ea417a1e0/copy"
}
},
"previewzip": {
"links": {
"self": "https://www.zohoapis.com/workdrive/api/v1/files/5jvqw0ccf2d470af54c86866b368ea417a1e0/relationships/previewzip",
"related": "https://www.zohoapis.com/workdrive/api/v1/files/5jvqw0ccf2d470af54c86866b368ea417a1e0/previewzip"
}
},
"tasks": {
"links": {
"self": "https://www.zohoapis.com/workdrive/api/v1/files/5jvqw0ccf2d470af54c86866b368ea417a1e0/relationships/tasks",
"related": "https://www.zohoapis.com/workdrive/api/v1/files/5jvqw0ccf2d470af54c86866b368ea417a1e0/tasks"
}
},
"custommetadata": {
"links": {
"self": "https://www.zohoapis.com/workdrive/api/v1/files/5jvqw0ccf2d470af54c86866b368ea417a1e0/relationships/custommetadata",
"related": "https://www.zohoapis.com/workdrive/api/v1/files/5jvqw0ccf2d470af54c86866b368ea417a1e0/custommetadata"
}
},
"deletedversions": {
"links": {
"self": "https://www.zohoapis.com/workdrive/api/v1/files/5jvqw0ccf2d470af54c86866b368ea417a1e0/relationships/deletedversions",
"related": "https://www.zohoapis.com/workdrive/api/v1/files/5jvqw0ccf2d470af54c86866b368ea417a1e0/deletedversions"
}
},
"comments": {
"links": {
"self": "https://www.zohoapis.com/workdrive/api/v1/files/5jvqw0ccf2d470af54c86866b368ea417a1e0/relationships/comments",
"related": "https://www.zohoapis.com/workdrive/api/v1/files/5jvqw0ccf2d470af54c86866b368ea417a1e0/comments"
}
},
"previewinfo": {
"links": {
"self": "https://www.zohoapis.com/workdrive/api/v1/files/5jvqw0ccf2d470af54c86866b368ea417a1e0/relationships/previewinfo",
"related": "https://www.zohoapis.com/workdrive/api/v1/files/5jvqw0ccf2d470af54c86866b368ea417a1e0/previewinfo"
}
},
"approvedversions": {
"links": {
"self": "https://www.zohoapis.com/workdrive/api/v1/files/5jvqw0ccf2d470af54c86866b368ea417a1e0/relationships/approvedversions",
"related": "https://www.zohoapis.com/workdrive/api/v1/files/5jvqw0ccf2d470af54c86866b368ea417a1e0/approvedversions"
}
},
"publiclink": {
"links": {
"self": "https://www.zohoapis.com/workdrive/api/v1/files/5jvqw0ccf2d470af54c86866b368ea417a1e0/relationships/publiclink",
"related": "https://www.zohoapis.com/workdrive/api/v1/files/5jvqw0ccf2d470af54c86866b368ea417a1e0/publiclink"
}
},
"parentfolders": {
"links": {
"self": "https://www.zohoapis.com/workdrive/api/v1/files/5jvqw0ccf2d470af54c86866b368ea417a1e0/relationships/parentfolders",
"related": "https://www.zohoapis.com/workdrive/api/v1/files/5jvqw0ccf2d470af54c86866b368ea417a1e0/parentfolders"
}
},
"versions": {
"links": {
"self": "https://www.zohoapis.com/workdrive/api/v1/files/5jvqw0ccf2d470af54c86866b368ea417a1e0/relationships/versions",
"related": "https://www.zohoapis.com/workdrive/api/v1/files/5jvqw0ccf2d470af54c86866b368ea417a1e0/versions"
}
},
"supportshare": {
"links": {
"self": "https://www.zohoapis.com/workdrive/api/v1/files/5jvqw0ccf2d470af54c86866b368ea417a1e0/relationships/supportshare",
"related": "https://www.zohoapis.com/workdrive/api/v1/files/5jvqw0ccf2d470af54c86866b368ea417a1e0/supportshare"
}
},
"startjourney": {
"links": {
"self": "https://www.zohoapis.com/workdrive/api/v1/files/5jvqw0ccf2d470af54c86866b368ea417a1e0/relationships/startjourney",
"related": "https://www.zohoapis.com/workdrive/api/v1/files/5jvqw0ccf2d470af54c86866b368ea417a1e0/startjourney"
}
},
"recordsuggestions": {
"links": {
"self": "https://www.zohoapis.com/workdrive/api/v1/files/5jvqw0ccf2d470af54c86866b368ea417a1e0/relationships/recordsuggestions",
"related": "https://www.zohoapis.com/workdrive/api/v1/files/5jvqw0ccf2d470af54c86866b368ea417a1e0/recordsuggestions"
}
},
"timeline": {
"links": {
"self": "https://www.zohoapis.com/workdrive/api/v1/files/5jvqw0ccf2d470af54c86866b368ea417a1e0/relationships/timeline",
"related": "https://www.zohoapis.com/workdrive/api/v1/files/5jvqw0ccf2d470af54c86866b368ea417a1e0/timeline"
}
},
"files": {
"links": {
"self": "https://www.zohoapis.com/workdrive/api/v1/files/5jvqw0ccf2d470af54c86866b368ea417a1e0/relationships/files",
"related": "https://www.zohoapis.com/workdrive/api/v1/files/5jvqw0ccf2d470af54c86866b368ea417a1e0/files"
}
},
"accessdata": {
"links": {
"self": "https://www.zohoapis.com/workdrive/api/v1/files/5jvqw0ccf2d470af54c86866b368ea417a1e0/relationships/accessdata",
"related": "https://www.zohoapis.com/workdrive/api/v1/files/5jvqw0ccf2d470af54c86866b368ea417a1e0/accessdata"
}
}
},
"links": {
"self": "https://www.zohoapis.com/workdrive/api/v1/files/5jvqw0ccf2d470af54c86866b368ea417a1e0"
}
}
]
}
{
"errors": [
{
"id": "CF070",
"title": "Invalid operation"
}
]
}
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.