Get Folders List
Purpose
To get a list of folders from your Writer account.
HTTP Request URL
https://{zohoapis_domain}/writer/api/v1/folders
Scope
ZohoWriter.documentEditor.ALL, ZohoPC.files.ALL, TeamDrive.files.ALL
Query Parameters
| Parameter | Data Type | Description |
| Optional Parameters | ||
| category | String | all Get the list of all folders available in your Writer account. owned_by_me Get only the list of folders which are owned by you. shared_to_me Get only the list of folders which are shared to you. |
Sample Request
Copiedcurl "https://www.zohoapis.com/writer/api/v1/folders
-X GET
-H "Authorization: Zoho-oauthtoken xyz"Sample Response
Copied"folders": [
{
"created_time": "2014-05-19T11:44:05Z",
"role": "OWNER",
"modified_time_ms": 1400499845384,
"parent_folder_id": "folder",
"last_opened_time": "2019-02-19T08:26:57Z",
"folder_name": "test",
"is_favourite": false,
"last_opened_time_ms": 1550564817538,
"type": "folder",
"created_by": "Amelia",
"created_time_ms": 1400499845384,
"modified_time": "2014-05-19T11:44:05Z",
"creator_id": "1308724",
"folder_id": "3yprg1a1713f36ec3477582f9ba8f1c56c90d",
"lastmodified_by": "Amelia",
"status": "active"
},
{
"created_time": "2015-03-31T06:11:38Z",
"role": "OWNER",
"modified_time_ms": 1427782298019,
"parent_folder_id": "folder",
"last_opened_time": "2018-11-29T14:45:41Z",
"folder_name": "PDF",
"is_favourite": false,
"last_opened_time_ms": 1543502741636,
"type": "folder",
"created_by": "Amelia",
"created_time_ms": 1427782298019,
"modified_time": "2015-03-31T06:11:38Z",
"creator_id": "1308724",
"folder_id": "lh6rdc7b48962f48d480299f6d4afafe72fb3",
"lastmodified_by": "Amelia",
"status": "active"
},
{
"created_time": "2015-12-18T11:12:03Z",
"role": "OWNER",
"modified_time_ms": 1450437123688,
"parent_folder_id": "folder",
"last_opened_time": "2018-07-03T12:49:12Z",
"folder_name": "Switch testing",
"is_favourite": false,
"last_opened_time_ms": 1530622152156,
"type": "folder",
"created_by": "Amelia",
"created_time_ms": 1450437123688,
"modified_time": "2015-12-18T11:12:03Z",
"creator_id": "1308724",
"folder_id": "xrbzpa8c579a1bf3c4f71a79a9ad77b7e4ec4",
"lastmodified_by": "Amelia",
"status": "active"
},
{
"created_time": "2017-09-19T07:50:39Z",
"role": "OWNER",
"modified_time_ms": 1505807439696,
"parent_folder_id": "folder",
"last_opened_time": "2018-12-23T15:52:24Z",
"folder_name": "Rest",
"is_favourite": false,
"last_opened_time_ms": 1545580344731,
"type": "folder",
"created_by": "Amelia",
"created_time_ms": 1505807439696,
"modified_time": "2017-09-19T07:50:39Z",
"creator_id": "1308724",
"folder_id": "1vq0ddcb202cbac404fdeb36e9a00727c6153",
"lastmodified_by": "Amelia",
"status": "active"
},
{
"created_time": "2018-01-11T10:33:02Z",
"role": "OWNER",
"modified_time_ms": 1515666782658,
"parent_folder_id": "folder",
"last_opened_time": "2018-01-11T10:41:07Z",
"folder_name": "Bus tickets",
"is_favourite": false,
"last_opened_time_ms": 1515667267591,
"type": "folder",
"created_by": "Amelia",
"created_time_ms": 1515666782658,
"modified_time": "2018-01-11T10:33:02Z",
"creator_id": "1308724",
"folder_id": "5nek5de8843cda4444a478510391327746941",
"lastmodified_by": "Amelia",
"status": "active"
},
{
"created_time": "2018-02-22T15:34:32Z",
"role": "OWNER",
"modified_time_ms": 1519313672203,
"parent_folder_id": "folder",
"last_opened_time": "2018-02-22T15:34:32Z",
"folder_name": "Reservation",
"is_favourite": false,
"last_opened_time_ms": 1519313672203,
"type": "folder",
"created_by": "Amelia",
"created_time_ms": 1519313672203,
"modified_time": "2018-02-22T15:34:32Z",
"creator_id": "1308724",
"folder_id": "af0u79a37f26e43da4f8f9a02ab4c604ad425",
"lastmodified_by": "Amelia",
"status": "active"
},
{
"created_time": "2018-03-09T07:35:34Z",
"role": "OWNER",
"modified_time_ms": 1520580934991,
"parent_folder_id": "folder",
"last_opened_time": "2019-02-19T09:40:34Z",
"folder_name": "One",
"is_favourite": false,
"last_opened_time_ms": 1550569234585,
"type": "folder",
"created_by": "Amelia",
"created_time_ms": 1520580934991,
"modified_time": "2018-03-09T07:35:34Z",
"creator_id": "1308724",
"folder_id": "af0u7deb63e7d06374e39a610fc988c38ed8a",
"lastmodified_by": "Amelia",
"status": "active"
},
{
"created_time": "2018-03-12T15:14:55Z",
"role": "OWNER",
"modified_time_ms": 1520867695424,
"parent_folder_id": "folder",
"last_opened_time": "2018-04-02T08:10:29Z",
"folder_name": "12 MAR 2018",
"is_favourite": false,
"last_opened_time_ms": 1522656629816,
"type": "folder",
"created_by": "Amelia",
"created_time_ms": 1520867695424,
"modified_time": "2018-03-12T15:14:55Z",
"creator_id": "1308724",
"folder_id": "af0u7e5d66c90c3b943d48824ee8b6e59a1db",
"lastmodified_by": "Amelia",
"status": "active"
},
{
"created_time": "2018-04-02T08:10:12Z",
"role": "OWNER",
"modified_time_ms": 1522656612586,
"parent_folder_id": "folder",
"last_opened_time": "2018-04-05T09:56:46Z",
"folder_name": "27 MAR 2018",
"is_favourite": false,
"last_opened_time_ms": 1522922206221,
"type": "folder",
"created_by": "Amelia",
"created_time_ms": 1522656612586,
"modified_time": "2018-04-02T08:10:12Z",
"creator_id": "1308724",
"folder_id": "d73mf4402232261b843af887ba2b4641e99f9",
"lastmodified_by": "Amelia",
"status": "active"
},
{
"created_time": "2018-04-05T09:55:33Z",
"role": "OWNER",
"modified_time_ms": 1522922133048,
"parent_folder_id": "folder",
"last_opened_time": "2018-04-05T09:55:33Z",
"folder_name": "Apr 5 2018",
"is_favourite": false,
"last_opened_time_ms": 1522922133048,
"type": "folder",
"created_by": "Amelia",
"created_time_ms": 1522922133048,
"modified_time": "2018-04-05T09:55:33Z",
"creator_id": "1308724",
"folder_id": "d73mfc16c204440ea450f8dff72074711c8f9",
"lastmodified_by": "Amelia",
"status": "active"
},
{
"created_time": "2018-05-17T13:33:05Z",
"role": "OWNER",
"modified_time_ms": 1526563985344,
"parent_folder_id": "folder",
"last_opened_time": "2018-05-17T13:35:18Z",
"folder_name": "May17",
"is_favourite": false,
"last_opened_time_ms": 1526564118104,
"type": "folder",
"created_by": "Amelia",
"created_time_ms": 1526563985344,
"modified_time": "2018-05-17T13:33:05Z",
"creator_id": "1308724",
"folder_id": "d73mf6f0c230bd8e94c21ab246a0afa6ad423",
"lastmodified_by": "Amelia",
"status": "active"
},
{
"created_time": "2018-08-02T08:09:53Z",
"role": "OWNER",
"modified_time_ms": 1533197393542,
"parent_folder_id": "folder",
"last_opened_time": "2018-11-22T12:18:37Z",
"folder_name": "Revenge",
"is_favourite": false,
"last_opened_time_ms": 1542889117151,
"type": "folder",
"created_by": "Amelia",
"created_time_ms": 1533197393542,
"modified_time": "2018-08-02T08:09:53Z",
"creator_id": "1308724",
"folder_id": "fctdpe7cdb000074e44bebe1e435f7be95f5d",
"lastmodified_by": Amelia",
"status": "active"
},
{
"created_time": "2018-11-22T08:20:57Z",
"role": "OWNER",
"modified_time_ms": 1542874857327,
"parent_folder_id": "folder",
"last_opened_time": "2018-11-22T08:20:57Z",
"folder_name": "Roaster",
"is_favourite": true,
"last_opened_time_ms": 1542874857327,
"type": "folder",
"created_by": "Amelia",
"created_time_ms": 1542874857327,
"modified_time": "2018-11-22T08:20:57Z",
"creator_id": "1308724",
"folder_id": "jafre5d0d5a5e8db34a43b435f3088ba61421",
"lastmodified_by": "Amelia",
"status": "active"
},
{
"created_time": "2018-11-22T08:26:30Z",
"role": "OWNER",
"modified_time_ms": 1542875190361,
"parent_folder_id": "folder",
"last_opened_time": "2018-11-22T08:26:30Z",
"folder_name": "22 Nov 2018",
"is_favourite": false,
"last_opened_time_ms": 1542875190361,
"type": "folder",
"created_by": "Amelia",
"created_time_ms": 1542875190361,
"modified_time": "2018-11-22T08:26:30Z",
"creator_id": "1308724",
"folder_id": "jafreab55f8fa5cdb4572bba26451e552b94a",
"lastmodified_by": "Amelia",
"status": "active"
},
{
"created_time": "2018-11-22T12:04:52Z",
"role": "OWNER",
"modified_time_ms": 1542888292524,
"parent_folder_id": "folder",
"last_opened_time": "2018-11-22T12:04:52Z",
"folder_name": "Edited documents",
"is_favourite": false,
"last_opened_time_ms": 1542888292524,
"type": "folder",
"created_by": "Amelia",
"created_time_ms": 1542888292524,
"modified_time": "2018-11-22T12:04:52Z",
"creator_id": "1308724",
"folder_id": "jafref8fdf39a74f942e497a519f557af2b6c",
"lastmodified_by": "Amelia",
"status": "active"
},
{
"created_time": "2018-11-29T14:39:08Z",
"role": "OWNER",
"modified_time_ms": 1543502348847,
"parent_folder_id": "folder",
"last_opened_time": "2018-12-24T06:20:55Z",
"folder_name": "29 Nov 2018",
"is_favourite": false,
"last_opened_time_ms": 1545632455004,
"type": "folder",
"created_by": "Amelia",
"created_time_ms": 1543502348847,
"modified_time": "2018-11-29T14:39:08Z",
"creator_id": "1308724",
"folder_id": "lw7b9aff596f1445444deb77a47afd99a18c5",
"lastmodified_by": "Amelia",
"status": "active"
},
{
"created_time": "2018-12-23T15:49:33Z",
"role": "OWNER",
"modified_time_ms": 1545580173064,
"parent_folder_id": "folder",
"last_opened_time": "2018-12-23T15:49:33Z",
"folder_name": "23Dec2018",
"is_favourite": false,
"last_opened_time_ms": 1545580173064,
"type": "folder",
"created_by": "Amelia",
"created_time_ms": 1545580173064,
"modified_time": "2018-12-23T15:49:33Z",
"creator_id": "1308724",
"folder_id": "lw7b916cadc3adc86494ba9476f464b0dbb0c",
"lastmodified_by": "Amelia",
"status": "active"
},
{
"created_time": "2019-02-06T02:39:20Z",
"role": "OWNER",
"modified_time_ms": 1549420760287,
"parent_folder_id": "folder",
"last_opened_time": "2019-02-19T09:37:52Z",
"folder_name": "23Dec2018",
"is_favourite": false,
"last_opened_time_ms": 1550569072101,
"type": "folder",
"created_by": "Amelia",
"created_time_ms": 1549420760287,
"modified_time": "2019-02-06T02:39:20Z",
"creator_id": "1308724",
"folder_id": "4gfw6f4c4603d3c10423393b373e2681fd648",
"lastmodified_by": "Amelia",
"status": "active"
},
{
"created_time": "2019-02-19T09:40:20Z",
"role": "OWNER",
"modified_time_ms": 1550569220711,
"parent_folder_id": "folder",
"last_opened_time": "2019-02-19T09:42:34Z",
"folder_name": "19Feb2019",
"is_favourite": false,
"last_opened_time_ms": 1550569354259,
"type": "folder",
"created_by": "Amelia",
"created_time_ms": 1550569220711,
"modified_time": "2019-02-19T09:40:20Z",
"creator_id": "1308724",
"folder_id": "h36bc7e4d648440a54d62b4a51e3d8e3fbc79",
"lastmodified_by": "Amelia",
"status": "active"
},
{
"created_time": "2019-02-19T09:41:23Z",
"role": "OWNER",
"modified_time_ms": 1550569283542,
"parent_folder_id": "folder",
"last_opened_time": "2019-02-19T09:41:23Z",
"folder_name": "Oceans",
"is_favourite": false,
"last_opened_time_ms": 1550569283542,
"type": "folder",
"created_by": "Amelia",
"created_time_ms": 1550569283542,
"modified_time": "2019-02-19T09:41:23Z",
"creator_id": "1308724",
"folder_id": "h36bc59843a5234834d728aaba20cc768f576",
"lastmodified_by": "Amelia",
"status": "active"
}
]
}Show full
Show less