Create Access Control

Grant access to a file or folder for a user or group

Parameters

Parameter	Type	Required	Description
`item_id`	`string`	Required	ID of the item to grant access to
`principal_id`	`string`	Required	User or Group ID to grant access to
`can_view`	`boolean`	Optional	Can view/list the item (default true)
`can_download`	`boolean`	Optional	Can download files (default true)
`can_upload`	`boolean`	Optional	Can upload files (for folders)
`can_delete`	`boolean`	Optional	Can delete items
`can_manage_permissions`	`boolean`	Optional	Can manage permissions for the item
`notify_on_download`	`boolean`	Optional	Notify principal when files are downloaded
`notify_on_upload`	`boolean`	Optional	Notify principal when files are uploaded
`send_notification`	`boolean`	Optional	Send email notification about the access grant
`message`	`string`	Optional	Message to include in the notification email

Examples

MCP Tool Call

{
  "name": "sharefile_createAccessControl",
  "arguments": {
    "item_id": "example",
    "principal_id": "example",
    "can_view": true,
    "can_download": true,
    "can_upload": true,
    "can_delete": true,
    "can_manage_permissions": true,
    "notify_on_download": true,
    "notify_on_upload": true,
    "send_notification": true,
    "message": "example"
  }
}

REST API

curl -X POST https://api.syncello.io/v1/tools/sharefile/createAccessControl \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "item_id": "example",
  "principal_id": "example",
  "can_view": true,
  "can_download": true,
  "can_upload": true,
  "can_delete": true,
  "can_manage_permissions": true,
  "notify_on_download": true,
  "notify_on_upload": true,
  "send_notification": true,
  "message": "example"
}'