files.com 1.0.281 → 1.0.284

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a512e9a1cf5610592440cb28438807256e0ce1dd62ada21abf077decc9e7aad9
-  data.tar.gz: c42677f79f36faf398f7eced5cd36ddb97f1122ee29013d036f4e4ec975d3bee
+  metadata.gz: 8fd4eab3efb137ddb0e2b4c597055334da75039bc7582ac286da5643de0512a0
+  data.tar.gz: 9f088873cf535eabdd03d60f5c4cc3cd7a80cf508f4ad83d66f5fe23cc2023d6
 SHA512:
-  metadata.gz: 98ddf1bf3441cf526e68e427f295004160323e83568f1185c0f825539bcac6910f7fef396f489807b8e7f11cec374912643a31f83ac04104fd5502e7d9a96474
-  data.tar.gz: 447eefd6bc63ac2df4431bf94976201fdf7533a5b21d3ff85a97e07cf9da7ca877cef82cb2f1af3b473da399923795623c2be2b57daf6f0d363f23b37f73aac4
+  metadata.gz: c1eb7ad577d5dc730be8a1f105c1a2f54b40aa4ea115f6103c95e6807aa93af7120a07f5732e52c53574fa605c0ff82df50131e026a4266d8f326228b190bfdf
+  data.tar.gz: af161e7e54102acf16115dce51e744c1372f0a1cdd183b83f8b54b28bb0bc4448f4e9fe05d99c350f797a613434da2790d1aed9306a910c1f1231a2c9884db22

data/_VERSION

@@ -1 +1 @@
-1.0.281
+1.0.284

data/docs/account_line_item.md

@@ -10,25 +10,29 @@
   "created_at": "2000-01-01T01:00:00Z",
   "currency": "USD",
   "download_uri": "https://url...",
-  "invoice_line_items": {
-    "amount": 1.0,
-    "created_at": "2000-01-01T01:00:00Z",
-    "description": "Service from 2019-01-01 through 2019-12-31",
-    "type": "invoice",
-    "service_end_at": "2000-01-01T01:00:00Z",
-    "service_start_at": "2000-01-01T01:00:00Z",
-    "updated_at": "2000-01-01T01:00:00Z",
-    "plan": "Enterprise",
-    "site": "My site"
-  },
+  "invoice_line_items": [
+    {
+      "amount": 1.0,
+      "created_at": "2000-01-01T01:00:00Z",
+      "description": "Service from 2019-01-01 through 2019-12-31",
+      "type": "invoice",
+      "service_end_at": "2000-01-01T01:00:00Z",
+      "service_start_at": "2000-01-01T01:00:00Z",
+      "updated_at": "2000-01-01T01:00:00Z",
+      "plan": "Premier",
+      "site": "My site"
+    }
+  ],
   "method": "paypal",
-  "payment_line_items": {
-    "amount": 1.0,
-    "created_at": "2000-01-01T01:00:00Z",
-    "invoice_id": 1,
-    "payment_id": 1,
-    "updated_at": "2000-01-01T01:00:00Z"
-  },
+  "payment_line_items": [
+    {
+      "amount": 1.0,
+      "created_at": "2000-01-01T01:00:00Z",
+      "invoice_id": 1,
+      "payment_id": 1,
+      "updated_at": "2000-01-01T01:00:00Z"
+    }
+  ],
   "payment_reversed_at": "2000-01-01T01:00:00Z",
   "payment_type": "",
   "site_name": "My Site",
@@ -43,9 +47,9 @@
 * `created_at` (date-time): Line item created at
 * `currency` (string): Line item currency
 * `download_uri` (string): Line item download uri
-* `invoice_line_items` (InvoiceLineItem): Associated invoice line items
+* `invoice_line_items` (array): Associated invoice line items
 * `method` (string): Line item payment method
-* `payment_line_items` (PaymentLineItem): Associated payment line items
+* `payment_line_items` (array): Associated payment line items
 * `payment_reversed_at` (date-time): Date/time payment was reversed if applicable
 * `payment_type` (string): Type of payment if applicable
 * `site_name` (string): Site name this line item is for

data/docs/app.md

@@ -31,7 +31,7 @@
 * `documentation_links` (object): Collection of named links to documentation
 * `icon_url` (string): App icon
 * `logo_url` (string): Full size logo for the App
-* `screenshot_list_urls` (string): Screenshots of the App
+* `screenshot_list_urls` (array): Screenshots of the App
 * `logo_thumbnail_url` (string): Logo thumbnail for the App
 * `sso_strategy_type` (string): Associated SSO Strategy type, if any
 * `remote_server_type` (string): Associated Remote Server type, if any

data/docs/automation.md

@@ -42,7 +42,9 @@
     2
   ],
   "webhook_url": "https://app.files.com/api/webhooks/abc123",
-  "trigger_actions": "[ \"create\" ]",
+  "trigger_actions": [
+    "[ \"create\" ]"
+  ],
   "value": "{\"limit\": \"1\"}"
 }
 ```
@@ -57,7 +59,7 @@
 * `name` (string): Name for this automation.
 * `schedule` (object): If trigger is `custom_schedule`, Custom schedule description for when the automation should be run.
 * `source` (string): Source Path
-* `destinations` (string): Destination Path
+* `destinations` (array): Destination Path
 * `destination_replace_from` (string): If set, this string in the destination path will be replaced with the value in `destination_replace_to`.
 * `destination_replace_to` (string): If set, this string will replace the value `destination_replace_from` in the destination filename. You can use special patterns here.
 * `description` (string): Description for the this Automation.
@@ -66,7 +68,7 @@
 * `user_ids` (array): IDs of Users for the Automation (i.e. who to Request File from)
 * `group_ids` (array): IDs of Groups for the Automation (i.e. who to Request File from)
 * `webhook_url` (string): If trigger is `webhook`, this is the URL of the webhook to trigger the Automation.
-* `trigger_actions` (string): If trigger is `action`, this is the list of action types on which to trigger the automation. Valid actions are create, read, update, destroy, move, copy
+* `trigger_actions` (array): If trigger is `action`, this is the list of action types on which to trigger the automation. Valid actions are create, read, update, destroy, move, copy
 * `value` (object): A Hash of attributes specific to the automation type.
 * `destination` (string): DEPRECATED: Destination Path. Use `destinations` instead.
 
@@ -125,7 +127,7 @@ Files::Automation.create(
   schedule: "{\"days_of_week\": [ 0, 1, 3 ], \"times_of_day\": [ \"7:30\", \"11:30\" ], \"time_zone\": \"Eastern Time (US & Canada)\"}", 
   disabled: true, 
   trigger: "realtime", 
-  trigger_actions: "[ \"create\" ]", 
+  trigger_actions: ["[ \"create\" ]"], 
   value: "{\"limit\": \"1\"}", 
   automation: "create_folder"
 )
@@ -166,7 +168,7 @@ Files::Automation.update(id,
   schedule: "{\"days_of_week\": [ 0, 1, 3 ], \"times_of_day\": [ \"7:30\", \"11:30\" ], \"time_zone\": \"Eastern Time (US & Canada)\"}", 
   disabled: true, 
   trigger: "realtime", 
-  trigger_actions: "[ \"create\" ]", 
+  trigger_actions: ["[ \"create\" ]"], 
   value: "{\"limit\": \"1\"}", 
   automation: "create_folder"
 )
@@ -223,7 +225,7 @@ automation.update(
   schedule: "{\"days_of_week\": [ 0, 1, 3 ], \"times_of_day\": [ \"7:30\", \"11:30\" ], \"time_zone\": \"Eastern Time (US & Canada)\"}",
   disabled: true,
   trigger: "realtime",
-  trigger_actions: "[ \"create\" ]",
+  trigger_actions: ["[ \"create\" ]"],
   value: "{\"limit\": \"1\"}",
   automation: "create_folder"
 )

data/docs/bundle.md

@@ -8,6 +8,7 @@
   "url": "https://subdomain.files.com/f/12345678",
   "description": "The public description of the bundle.",
   "password_protected": true,
+  "permissions": "read",
   "preview_only": true,
   "require_registration": true,
   "require_share_recipient": true,
@@ -21,20 +22,22 @@
       3,
       4
     ],
-    "form_fields": {
-      "id": 1,
-      "label": "Sample Label",
-      "required": true,
-      "help_text": "Help Text",
-      "field_type": "text",
-      "options_for_select": [
-        "red",
-        "green",
-        "blue"
-      ],
-      "default_option": "red",
-      "form_field_set_id": 1
-    },
+    "form_fields": [
+      {
+        "id": 1,
+        "label": "Sample Label",
+        "required": true,
+        "help_text": "Help Text",
+        "field_type": "text",
+        "options_for_select": [
+          "red",
+          "green",
+          "blue"
+        ],
+        "default_option": "red",
+        "form_field_set_id": 1
+      }
+    ],
     "skip_name": true,
     "skip_email": true,
     "skip_company": true
@@ -67,6 +70,7 @@
 * `url` (string): Public URL of Share Link
 * `description` (string): Public description
 * `password_protected` (boolean): Is this bundle password protected?
+* `permissions` (string): Permissions that apply to Folders in this Share Link.
 * `preview_only` (boolean): Restrict users to previewing files only?
 * `require_registration` (boolean): Show a registration page that captures the downloader's name and email address?
 * `require_share_recipient` (boolean): Only allow access to recipients who have explicitly received the share via an email sent through the Files.com UI?
@@ -147,6 +151,7 @@ Files::Bundle.create(
   description: "The public description of the bundle.", 
   note: "The internal note on the bundle.", 
   code: "abc123", 
+  permissions: "read", 
   preview_only: true, 
   require_registration: true, 
   clickwrap_id: 1, 
@@ -169,6 +174,7 @@ Files::Bundle.create(
 * `description` (string): Public description
 * `note` (string): Bundle internal note
 * `code` (string): Bundle code.  This code forms the end part of the Public URL.
+* `permissions` (string): Permissions that apply to Folders in this Share Link.
 * `preview_only` (boolean): Restrict users to previewing files only?
 * `require_registration` (boolean): Show a registration page that captures the downloader's name and email address?
 * `clickwrap_id` (int64): ID of the clickwrap to use with this bundle.
@@ -216,6 +222,7 @@ Files::Bundle.update(id,
   inbox_id: 1, 
   max_uses: 1, 
   note: "The internal note on the bundle.", 
+  permissions: "read", 
   preview_only: true, 
   require_registration: true, 
   require_share_recipient: true, 
@@ -239,6 +246,7 @@ Files::Bundle.update(id,
 * `inbox_id` (int64): ID of the associated inbox, if available.
 * `max_uses` (int64): Maximum number of times bundle can be accessed
 * `note` (string): Bundle internal note
+* `permissions` (string): Permissions that apply to Folders in this Share Link.
 * `preview_only` (boolean): Restrict users to previewing files only?
 * `require_registration` (boolean): Show a registration page that captures the downloader's name and email address?
 * `require_share_recipient` (boolean): Only allow access to recipients who have explicitly received the share via an email sent through the Files.com UI?
@@ -302,6 +310,7 @@ bundle.update(
   inbox_id: 1,
   max_uses: 1,
   note: "The internal note on the bundle.",
+  permissions: "read",
   preview_only: true,
   require_registration: true,
   require_share_recipient: true,
@@ -325,6 +334,7 @@ bundle.update(
 * `inbox_id` (int64): ID of the associated inbox, if available.
 * `max_uses` (int64): Maximum number of times bundle can be accessed
 * `note` (string): Bundle internal note
+* `permissions` (string): Permissions that apply to Folders in this Share Link.
 * `preview_only` (boolean): Restrict users to previewing files only?
 * `require_registration` (boolean): Show a registration page that captures the downloader's name and email address?
 * `require_share_recipient` (boolean): Only allow access to recipients who have explicitly received the share via an email sent through the Files.com UI?

data/docs/file.md

@@ -11,6 +11,7 @@ may places where a Ruby File object can be used.
   "display_name": "file.txt",
   "type": "file",
   "size": 1024,
+  "created_at": "2000-01-01T01:00:00Z",
   "mtime": "2000-01-01T01:00:00Z",
   "provided_mtime": "2000-01-01T01:00:00Z",
   "crc32": "70976923",
@@ -36,6 +37,7 @@ may places where a Ruby File object can be used.
 * `display_name` (string): File/Folder display name
 * `type` (string): Type: `directory` or `file`.
 * `size` (int64): File/Folder size
+* `created_at` (date-time): File created date/time
 * `mtime` (date-time): File last modified date/time, according to the server.  This is the timestamp of the last Files.com operation of the file, regardless of what modified timestamp was sent.
 * `provided_mtime` (date-time): File last modified date/time, according to the client who set it.  Files.com allows desktop, FTP, SFTP, and WebDAV clients to set modified at times.  This allows Desktop<->Cloud syncing to preserve modified at times.
 * `crc32` (string): File CRC32 checksum. This is sometimes delayed, so if you get a blank response, wait and try again.

data/docs/file_comment.md

@@ -6,16 +6,18 @@
 {
   "id": 1,
   "body": "What a great file!",
-  "reactions": {
-    "id": 1,
-    "emoji": "👍"
-  }
+  "reactions": [
+    {
+      "id": 1,
+      "emoji": "👍"
+    }
+  ]
 }
 ```
 
 * `id` (int64): File Comment ID
 * `body` (string): Comment body.
-* `reactions` (FileCommentReaction): Reactions to this comment.
+* `reactions` (array): Reactions to this comment.
 * `path` (string): File path.
 
 

data/docs/folder.md

@@ -13,6 +13,7 @@ Files::Dir is an alias of Files::Folder
   "display_name": "file.txt",
   "type": "file",
   "size": 1024,
+  "created_at": "2000-01-01T01:00:00Z",
   "mtime": "2000-01-01T01:00:00Z",
   "provided_mtime": "2000-01-01T01:00:00Z",
   "crc32": "70976923",
@@ -38,6 +39,7 @@ Files::Dir is an alias of Files::Folder
 * `display_name` (string): File/Folder display name
 * `type` (string): Type: `directory` or `file`.
 * `size` (int64): File/Folder size
+* `created_at` (date-time): File created date/time
 * `mtime` (date-time): File last modified date/time, according to the server.  This is the timestamp of the last Files.com operation of the file, regardless of what modified timestamp was sent.
 * `provided_mtime` (date-time): File last modified date/time, according to the client who set it.  Files.com allows desktop, FTP, SFTP, and WebDAV clients to set modified at times.  This allows Desktop<->Cloud syncing to preserve modified at times.
 * `crc32` (string): File CRC32 checksum. This is sometimes delayed, so if you get a blank response, wait and try again.

data/docs/form_field.md

@@ -24,6 +24,6 @@
 * `required` (boolean): Is this a required field?
 * `help_text` (string): Help text to be displayed
 * `field_type` (string): Type of Field
-* `options_for_select` (string): Options to display for radio and dropdown
+* `options_for_select` (array): Options to display for radio and dropdown
 * `default_option` (string): Default option for radio and dropdown
 * `form_field_set_id` (int64): Form field set id

data/docs/form_field_set.md

@@ -12,20 +12,22 @@
     3,
     4
   ],
-  "form_fields": {
-    "id": 1,
-    "label": "Sample Label",
-    "required": true,
-    "help_text": "Help Text",
-    "field_type": "text",
-    "options_for_select": [
-      "red",
-      "green",
-      "blue"
-    ],
-    "default_option": "red",
-    "form_field_set_id": 1
-  },
+  "form_fields": [
+    {
+      "id": 1,
+      "label": "Sample Label",
+      "required": true,
+      "help_text": "Help Text",
+      "field_type": "text",
+      "options_for_select": [
+        "red",
+        "green",
+        "blue"
+      ],
+      "default_option": "red",
+      "form_field_set_id": 1
+    }
+  ],
   "skip_name": true,
   "skip_email": true,
   "skip_company": true
@@ -34,8 +36,8 @@
 
 * `id` (int64): Form field set id
 * `title` (string): Title to be displayed
-* `form_layout` (int64): Layout of the form
-* `form_fields` (FormField): Associated form fields
+* `form_layout` (array): Layout of the form
+* `form_fields` (array): Associated form fields
 * `skip_name` (boolean): Any associated InboxRegistrations or BundleRegistrations can be saved without providing name
 * `skip_email` (boolean): Any associated InboxRegistrations or BundleRegistrations can be saved without providing email
 * `skip_company` (boolean): Any associated InboxRegistrations or BundleRegistrations can be saved without providing company
@@ -84,7 +86,7 @@ Files::FormFieldSet.create(
   skip_email: true, 
   skip_name: true, 
   skip_company: true, 
-  form_fields: {"label":"Sample Label","required":true,"help_text":"Help Text","field_type":"text","options_for_select":["red","green","blue"],"default_option":"red","form_field_set_id":1}
+  form_fields: [{"label":"Sample Label","required":true,"help_text":"Help Text","field_type":"text","options_for_select":["red","green","blue"],"default_option":"red","form_field_set_id":1}]
 )
 ```
 
@@ -108,7 +110,7 @@ Files::FormFieldSet.update(id,
   skip_email: true, 
   skip_name: true, 
   skip_company: true, 
-  form_fields: {"id":1,"label":"Sample Label","required":true,"help_text":"Help Text","field_type":"text","options_for_select":["red","green","blue"],"default_option":"red","form_field_set_id":1}
+  form_fields: [{"id":1,"label":"Sample Label","required":true,"help_text":"Help Text","field_type":"text","options_for_select":["red","green","blue"],"default_option":"red","form_field_set_id":1}]
 )
 ```
 
@@ -147,7 +149,7 @@ form_field_set.update(
   skip_email: true,
   skip_name: true,
   skip_company: true,
-  form_fields: {"id":1,"label":"Sample Label","required":true,"help_text":"Help Text","field_type":"text","options_for_select":["red","green","blue"],"default_option":"red","form_field_set_id":1}
+  form_fields: [{"id":1,"label":"Sample Label","required":true,"help_text":"Help Text","field_type":"text","options_for_select":["red","green","blue"],"default_option":"red","form_field_set_id":1}]
 )
 ```
 

data/docs/group.md

@@ -6,25 +6,19 @@
 {
   "id": 1,
   "name": "owners",
-  "admin_ids": [
-    1
-  ],
+  "admin_ids": "1",
   "notes": "",
-  "user_ids": [
-    1
-  ],
-  "usernames": [
-    "user"
-  ]
+  "user_ids": "1",
+  "usernames": "user"
 }
 ```
 
 * `id` (int64): Group ID
 * `name` (string): Group name
-* `admin_ids` (string): List of user IDs who are group administrators (separated by commas)
+* `admin_ids` (string): Comma-delimited list of user IDs who are group administrators (separated by commas)
 * `notes` (string): Notes about this group
-* `user_ids` (array): List of user IDs who belong to this group (separated by commas)
-* `usernames` (array): List of usernames who belong to this group (separated by commas)
+* `user_ids` (string): Comma-delimited list of user IDs who belong to this group (separated by commas)
+* `usernames` (string): Comma-delimited list of usernames who belong to this group (separated by commas)
 
 
 ---
@@ -71,8 +65,8 @@ Files::Group.find(id)
 ```
 Files::Group.create(
   name: "owners", 
-  user_ids: [1], 
-  admin_ids: [1]
+  user_ids: "1", 
+  admin_ids: "1"
 )
 ```
 
@@ -91,8 +85,8 @@ Files::Group.create(
 ```
 Files::Group.update(id, 
   name: "owners", 
-  user_ids: [1], 
-  admin_ids: [1]
+  user_ids: "1", 
+  admin_ids: "1"
 )
 ```
 
@@ -127,8 +121,8 @@ group = Files::Group.list.first
 
 group.update(
   name: "owners",
-  user_ids: [1],
-  admin_ids: [1]
+  user_ids: "1",
+  admin_ids: "1"
 )
 ```
 

data/docs/invoice.md

@@ -10,25 +10,29 @@
   "created_at": "2000-01-01T01:00:00Z",
   "currency": "USD",
   "download_uri": "https://url...",
-  "invoice_line_items": {
-    "amount": 1.0,
-    "created_at": "2000-01-01T01:00:00Z",
-    "description": "Service from 2019-01-01 through 2019-12-31",
-    "type": "invoice",
-    "service_end_at": "2000-01-01T01:00:00Z",
-    "service_start_at": "2000-01-01T01:00:00Z",
-    "updated_at": "2000-01-01T01:00:00Z",
-    "plan": "Enterprise",
-    "site": "My site"
-  },
+  "invoice_line_items": [
+    {
+      "amount": 1.0,
+      "created_at": "2000-01-01T01:00:00Z",
+      "description": "Service from 2019-01-01 through 2019-12-31",
+      "type": "invoice",
+      "service_end_at": "2000-01-01T01:00:00Z",
+      "service_start_at": "2000-01-01T01:00:00Z",
+      "updated_at": "2000-01-01T01:00:00Z",
+      "plan": "Premier",
+      "site": "My site"
+    }
+  ],
   "method": "paypal",
-  "payment_line_items": {
-    "amount": 1.0,
-    "created_at": "2000-01-01T01:00:00Z",
-    "invoice_id": 1,
-    "payment_id": 1,
-    "updated_at": "2000-01-01T01:00:00Z"
-  },
+  "payment_line_items": [
+    {
+      "amount": 1.0,
+      "created_at": "2000-01-01T01:00:00Z",
+      "invoice_id": 1,
+      "payment_id": 1,
+      "updated_at": "2000-01-01T01:00:00Z"
+    }
+  ],
   "payment_reversed_at": "2000-01-01T01:00:00Z",
   "payment_type": "",
   "site_name": "My Site",
@@ -43,9 +47,9 @@
 * `created_at` (date-time): Line item created at
 * `currency` (string): Line item currency
 * `download_uri` (string): Line item download uri
-* `invoice_line_items` (InvoiceLineItem): Associated invoice line items
+* `invoice_line_items` (array): Associated invoice line items
 * `method` (string): Line item payment method
-* `payment_line_items` (PaymentLineItem): Associated payment line items
+* `payment_line_items` (array): Associated payment line items
 * `payment_reversed_at` (date-time): Date/time payment was reversed if applicable
 * `payment_type` (string): Type of payment if applicable
 * `site_name` (string): Site name this line item is for

data/docs/invoice_line_item.md

@@ -11,7 +11,7 @@
   "service_end_at": "2000-01-01T01:00:00Z",
   "service_start_at": "2000-01-01T01:00:00Z",
   "updated_at": "2000-01-01T01:00:00Z",
-  "plan": "Enterprise",
+  "plan": "Premier",
   "site": "My site"
 }
 ```

data/docs/message.md

@@ -7,21 +7,25 @@
   "id": 1,
   "subject": "Files.com Account Upgrade",
   "body": "We should upgrade our Files.com account!",
-  "comments": {
-    "id": 1,
-    "body": "What a great idea, thank you!",
-    "reactions": {
+  "comments": [
+    {
       "id": 1,
-      "emoji": "👍"
+      "body": "What a great idea, thank you!",
+      "reactions": [
+        {
+          "id": 1,
+          "emoji": "👍"
+        }
+      ]
     }
-  }
+  ]
 }
 ```
 
 * `id` (int64): Message ID
 * `subject` (string): Message subject.
 * `body` (string): Message body.
-* `comments` (MessageComment): Comments.
+* `comments` (array): Comments.
 * `user_id` (int64): User ID.  Provide a value of `0` to operate the current session's user.
 * `project_id` (int64): Project to which the message should be attached.
 

data/docs/message_comment.md

@@ -6,16 +6,18 @@
 {
   "id": 1,
   "body": "What a great idea, thank you!",
-  "reactions": {
-    "id": 1,
-    "emoji": "👍"
-  }
+  "reactions": [
+    {
+      "id": 1,
+      "emoji": "👍"
+    }
+  ]
 }
 ```
 
 * `id` (int64): Message Comment ID
 * `body` (string): Comment body.
-* `reactions` (MessageCommentReaction): Reactions to this comment.
+* `reactions` (array): Reactions to this comment.
 * `user_id` (int64): User ID.  Provide a value of `0` to operate the current session's user.
 
 

data/docs/notification.md

@@ -40,8 +40,8 @@
 * `path` (string): Folder path to notify on This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
 * `group_id` (int64): Notification group id
 * `group_name` (string): Group name if applicable
-* `triggering_group_ids` (int64): Only notify on actions made by a member of one of the specified groups
-* `triggering_user_ids` (int64): Only notify on actions made one of the specified users
+* `triggering_group_ids` (array): Only notify on actions made by a member of one of the specified groups
+* `triggering_user_ids` (array): Only notify on actions made one of the specified users
 * `trigger_by_share_recipients` (boolean): Notify when actions are performed by a share recipient?
 * `notify_user_actions` (boolean): Trigger notification on notification user actions?
 * `notify_on_copy` (boolean): Triggers notification when copying files to this path