Add or change room granted group(s)

v1.0.0

Description:

All existing group permissions will be overwritten.

Precondition:

User needs to be a 👤 Room Administrator. To add new members, the user needs the right 🔓 non-members add, which is included in any role.

Postcondition:

Group's permissions are changed.

Further Information:

Batch function.

Input

{
  "type": "object",
  "properties": {
    "X-Sds-Auth-Token": {
      "type": "string"
    },
    "items": {
      "type": "array",
      "description": "List of room-group mappings",
      "items": {
        "type": "object",
        "description": "Request item model for granting group to the room",
        "required": [
          "id",
          "permissions"
        ],
        "properties": {
          "id": {
            "type": "integer",
            "format": "int64",
            "description": "Unique identifier for the group"
          },
          "newGroupMemberAcceptance": {
            "type": "string",
            "description": "Behaviour when new users are added to the group:\n\n* `autoallow`\n\n* `pending`\n\n\n\nOnly relevant if `adminGroupIds` has items.",
            "enum": [
              "autoallow",
              "pending"
            ]
          },
          "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
}