Folder Permissions

After enabling Advanced Permissions, you can configure a folder with granular access to individual users.

Advanced Folder Permissions

Get folder permissions

GET https://api.couchdrop.io/manage/fileprops/permissions

Get permissions for a specific folder.

Query Parameters

Name	Type	Description
path	string	Folder to get permission details.

Headers

Name	Type	Description
token	string	API Access Token

200 Cake successfully retrieved.

{"result": [{"username": "user-38f92ce5", 
    "account": "michael", 
    "lstat": true, 
    "upload": false, 
    "ls": true, 
    "download": true, 
    "path": "/test_folder", 
    "id": "38f92ce5-700f-4f4d-8557-df6f5e8d9b80 "}]}

403 Authentication Invalid

Add/Update folder permissions

POST https://api.couchdrop.io/manage/fileprops/permissions

Add new or update existing folder properties.

Headers

Name	Type	Description
token	string	API Access Token

Request Body

Name	Type	Description
path	string	Folder to grant user permissions on.
username	string	User to grant permissions on.
download	boolean	Grant Download permissions to user.
upload	boolean	Grant Upload permissions to user.
delete	boolean	Grant Delete permissions to user.
lstat	boolean	Grant LSTAT permissions to user.
ls	boolean	Grant LS permissions to user.

200 Successfully added permissions for user.

{}

403 Authentication Invalid.

Delete folder permissions

DELETE https://api.couchdrop.io/manage/fileprops/permissions/<permission_id>

Delete permissions from a specific folder.

Path Parameters

Name	Type	Description
permission_id	string	ID of the permission to be deleted

Headers

Name	Type	Description
token	string	API Access Token

200 Successfully deleted permission.

{}

403 Authentication Invalid.