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
Query Parameters
token
required
string
Authentication Token.
path
optional
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
Query Parameters
token
required
string
Authentication 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.
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
Delete permissions from a specific folder.
Request
Response
Request
Path Parameters
permission_id
required
string
ID of permission to be deleted.
Query Parameters
token
required
string
Authentication Token.
Response
200: OK
Successfully deleted permission.
{}
403: Forbidden
Authentication Invalid.