Managing Folder Permissions

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

Advanced Folder Permissions

get
Get folder permissions

https://api.couchdrop.io/manage/fileprops/permissions
Get permissions for a specific folder.
Request
Response
Request
Headers
token
required
string
API Access Token
Query Parameters
path
required
string
Folder to get permission details.
Response
200: OK
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: Forbidden
Authentication Invalid

post
Add/Update folder permissions

https://api.couchdrop.io/manage/fileprops/permissions
Add new or update existing folder properties.
Request
Response
Request
Headers
token
required
string
API Access Token
Body Parameters
path
required
string
Folder to grant user permissions on.
username
required
string
User to grant permissions on.
download
optional
boolean
Grant Download permissions to user.
upload
optional
boolean
Grant Upload permissions to user.
delete
optional
boolean
Grant Delete permissions to user.
lstat
optional
boolean
Grant LSTAT permissions to user.
ls
optional
boolean
Grant LS permissions to user.
Response
200: OK
Successfully added permissions for user.
{}
403: Forbidden
Authentication Invalid.

delete
Delete folder permissions

https://api.couchdrop.io/manage/fileprops/permissions/<permission_id>
Delete permissions from a specific folder.
Request
Response
Request
Path Parameters
permission_id
required
string
ID of the permission to be deleted
Headers
token
required
string
API Access Token
Response
200: OK
Successfully deleted permission.
{}
403: Forbidden
Authentication Invalid.