• Register

User Insights API

The User Insights API provides you with information about files a user has recently accessed.

List Recent Files

This endpoint is used to list all [recent] files for the authenticated user.

GET/pubapi/v1/insights/files

Request Parameters: None

Method-specific Response Codes

Error Code Error Message HTTP Code Troubleshooting
OK The request was fulfilled. 200 The request was valid and the response will be returned.
Unauthorized Developer inactive. 401 Make sure the access token is valid.

Request Examples

GET /pubapi/v1/insights/files HTTP/1.1
Host: apidemo.egnyte.com
Authorization: Bearer 68zc95e3xv954u6k3hbnma3q
curl -v --request GET -H "Authorization: Bearer 68zc95e3xv954u6k3hbnma3q" https://apidemo.egnyte.com/pubapi/v1/insights/files

Sample Response

The "size" is returned in bytes. The time (both: in "last_modified" and "last_accessed" variables) has the "Unix time" format.

The maximum number of results (this API call returns) is 10.

{
	"recentFiles":[
	{
		"name":"Outline.docx",
		"path":"/Private/johndoe/Drafts/Outline.docx",
		"size":307951,
		"entry_id":"cba6286d-bad8-43c8-8176-07bb21ef209f",
		"group_id":"84792f80-2f1e-416d-a6c0-ba6fd1855dbb",
		"uploaded_by":"John Doe",
		"num_versions":2,
		"last_modified":1542833068000, 
		"last_accessed":1542945701862, 
		"recommendation_type":"recent"
	},
	{
		"name":"test file for egnyte.ppsx",
		"path":"/Private/johndoe/Presentations/SlideShow.ppsx",
		"size":5327450,
		"entry_id":"4c68ac52-f4a1-494a-86a1-ad2f8c6966e5",
		"group_id":"1ec9e82e-b587-4118-a1c3-b0bde264165b",
		"uploaded_by":"John Doe",
		"num_versions":0,
		"last_modified":1542823959000,
		"last_accessed":1542945442611,
		"recommendation_type":"recent"
	},{
		"name":"Presentation1.pptx",
		"path":"/Shared/Documents/Presentation1.pptx",
		"size":175352,
		"entry_id":"b0b17eaf-2068-49bd-85e7-fc60cad58d58",
		"group_id":"31b9bbbf-5132-4d8d-867b-3e8657de70b8",
		"uploaded_by":"Chelsea Sutton",
		"num_versions":0,
		"last_modified":1533162184000,
		"last_accessed":1541529105667,
		"recommendation_type":"recent"
	}]
}