Creates a new sharing object for a folder by specifying the email of the person to share with and other optional parameters.

Requires api token with one of the following permissions

Read, update & delete anything

Tokens with the "Act with a team member's permissions" permission (all:delegate_to_contact_permissions scope) can also be used. Requests made with such a token are authorized using the permissions of the contact assigned to the token.

An expiring access token created with the all:delegate_to_contact_permissions scope and an authorization granting the share permission on this folder can also be used.

{
  "project": "http://myaccount.wistia.com/folders/13",
  "sharing": {
    "id": 14,
    "is_admin": true,
    "can_share": true,
    "can_download": true,
    "can_upload": true,
    "share": {
      "id": 3,
      "name": "Jim",
      "type": "Contact",
      "email": "jim@wistia.com"
    },
    "folder": {
      "id": 13,
      "name": "My Folder"
    }
  }
}