{"_id":"5804cb25d1b3990f0020897e","project":"55faf11ba62ba1170021a9a7","parentDoc":null,"version":{"_id":"55faf11ba62ba1170021a9aa","project":"55faf11ba62ba1170021a9a7","__v":38,"createdAt":"2015-09-17T16:58:03.490Z","releaseDate":"2015-09-17T16:58:03.490Z","categories":["55faf11ca62ba1170021a9ab","55faf8f4d0e22017005b8272","55faf91aa62ba1170021a9b5","55faf929a8a7770d00c2c0bd","55faf932a8a7770d00c2c0bf","55faf94b17b9d00d00969f47","55faf958d0e22017005b8274","55faf95fa8a7770d00c2c0c0","55faf96917b9d00d00969f48","55faf970a8a7770d00c2c0c1","55faf98c825d5f19001fa3a6","55faf99aa62ba1170021a9b8","55faf99fa62ba1170021a9b9","55faf9aa17b9d00d00969f49","55faf9b6a8a7770d00c2c0c3","55faf9bda62ba1170021a9ba","5604570090ee490d00440551","5637e8b2fbe1c50d008cb078","5649bb624fa1460d00780add","5671974d1b6b730d008b4823","5671979d60c8e70d006c9760","568e8eef70ca1f0d0035808e","56d0a2081ecc471500f1795e","56d4a0adde40c70b00823ea3","56d96b03dd90610b00270849","56fbb83d8f21c817002af880","573c811bee2b3b2200422be1","576bc92afb62dd20001cda85","5771811e27a5c20e00030dcd","5785191af3a10c0e009b75b0","57bdf84d5d48411900cd8dc0","57ff5c5dc135231700aed806","5804caf792398f0f00e77521","58458b4fba4f1c0f009692bb","586d3c287c6b5b2300c05055","58ef66d88646742f009a0216","58f5d52d7891630f00fe4e77","59a555bccdbd85001bfb1442"],"is_deprecated":false,"is_hidden":false,"is_beta":true,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"__v":0,"category":{"_id":"5804caf792398f0f00e77521","__v":0,"project":"55faf11ba62ba1170021a9a7","version":"55faf11ba62ba1170021a9aa","sync":{"url":"","isSync":false},"reference":true,"createdAt":"2016-10-17T12:58:31.759Z","from_sync":false,"order":30,"slug":"folders-api-advance-access","title":"FOLDERS API (Advance Access)"},"user":"566590c83889610d0008a253","updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-10-17T12:59:17.185Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":true,"order":0,"body":"[block:callout]\n{\n  \"type\": \"danger\",\n  \"title\": \"Heads Up!\",\n  \"body\": \"This page documents the Advanced Access version (think \\\"beta\\\" but with fewer bugs) of the folders functionality.\"\n}\n[/block]\nThe Folders functionality is an advance access feature which allows you to create and organize folders on the CGC via dedicated API calls. Folders are created inside projects, and can be used to contain files within the project.\n\nCreating folders on the CGC allows you to mirror an external file structure with your files inside a project.\n\nIn the initial release, the folders created via the API will not be visible in the visual interface, nor will be the files which you add to those folders.\n\nThe following API calls have been added:\n\n  * [Create a folder](doc:create-a-folder)\n  * [List folder contents](doc:list-folder-contents)\n  * [Move a file between folders](doc:move-a-file-between-folders)\n  * [Copy a file between folders](doc:copy-a-file-between-folders)\n  * [Delete a folder](doc:delete-a-folder)\n  \nIn addition, some existing API calls have been updated to optionally include \"advance access\" header parameter and provide additional information related to folders:\n\n  * **Get details of a project** - returns the ID of the project's main folder (root folder).\n  * **Get file details** - returns the ID of the file's parent folder.\n  * **Delete a file** - allows deleting a file by specifying it's parent folder.","excerpt":"","slug":"folders-overview","type":"basic","title":"Folders Overview"}
[block:callout] { "type": "danger", "title": "Heads Up!", "body": "This page documents the Advanced Access version (think \"beta\" but with fewer bugs) of the folders functionality." } [/block] The Folders functionality is an advance access feature which allows you to create and organize folders on the CGC via dedicated API calls. Folders are created inside projects, and can be used to contain files within the project. Creating folders on the CGC allows you to mirror an external file structure with your files inside a project. In the initial release, the folders created via the API will not be visible in the visual interface, nor will be the files which you add to those folders. The following API calls have been added: * [Create a folder](doc:create-a-folder) * [List folder contents](doc:list-folder-contents) * [Move a file between folders](doc:move-a-file-between-folders) * [Copy a file between folders](doc:copy-a-file-between-folders) * [Delete a folder](doc:delete-a-folder) In addition, some existing API calls have been updated to optionally include "advance access" header parameter and provide additional information related to folders: * **Get details of a project** - returns the ID of the project's main folder (root folder). * **Get file details** - returns the ID of the file's parent folder. * **Delete a file** - allows deleting a file by specifying it's parent folder.