action dracoon_update_room_users {
  label: "Add or change room granted user(s)"
  description: "### Description:\nAll existing user permissions will be overwritten.\n\n### Precondition:\nUser needs to be a <span style='padding: 3px; background-color: #F6F7F8; border: 1px solid #000; border-radius: 5px; display: inline;'>&#128100; Room Administrator</span>. To add new members, the user needs the right <span style='padding: 3px; background-color: #F6F7F8; border: 1px solid #000; border-radius: 5px; display: inline;'>&#128275; non-members add</span>, which is included in any role.\n\n### Postcondition:\nUser's permissions are changed.\n\n### Further Information:\nBatch function."
  provider: dracoon
  method: PUT
  path: "/v4/nodes/rooms/{room_id}/users"
  encoding: json
  input: {
    type: "object"
    properties: {
      "X-Sds-Auth-Token": {
        type: "string"
      }
      items: {
        type: "array"
        description: "List of room-user mappings"
        items: {
          type: "object"
          description: "Request item model for granting user to the room"
          required: ["id", "permissions"]
          properties: {
            id: {
              type: "integer"
              format: "int64"
              description: "Unique identifier for the user"
            }
            permissions: {
              type: "object"
              description: "Node permissions"
              required: ["change", "create", "delete", "deleteRecycleBin", "manage", "manageDownloadShare", "manageUploadShare", "read", "readRecycleBin", "restoreRecycleBin"]
              properties: {
                change: {
                  type: "boolean"
                  description: "User / Group may update metadata of nodes: rename files and folders, change classification, etc."
                }
                create: {
                  type: "boolean"
                  description: "User / Group may upload files, create folders and copy / move files to this room, overwriting is not possible."
                }
                delete: {
                  type: "boolean"
                  description: "User / Group may overwrite and remove files / folders, move files from this room."
                }
                deleteRecycleBin: {
                  type: "boolean"
                  description: "User / Group may permanently remove files / folders from the recycle bin."
                }
                manage: {
                  type: "boolean"
                  description: "User / Group may grant all of the above permissions to other users and groups independently,\n\nmay update room metadata and create / update / delete subordinary rooms, has all permissions."
                }
                manageDownloadShare: {
                  type: "boolean"
                  description: "User / Group may create Download Shares for files and containers view all previously created Download Shares in this room."
                }
                manageUploadShare: {
                  type: "boolean"
                  description: "User / Group may create Upload Shares for containers, view all previously created Upload Shares in this room."
                }
                read: {
                  type: "boolean"
                  description: "User / Group may see all rooms, files and folders in the room and download everything, copy files from this room."
                }
                readRecycleBin: {
                  type: "boolean"
                  description: "User / Group may look up files / folders in the recycle bin."
                }
                restoreRecycleBin: {
                  type: "boolean"
                  description: "User / Group may restore files / folders from recycle bin - room permissions required."
                }
              }
            }
          }
        }
      }
      room_id: {
        type: "integer"
        format: "int64"
      }
    }
    required: ["items", "room_id"]
    additionalProperties: false
  }
  output: {
    type: "object"
    additionalProperties: true
  }
}