Request

Response

    Change Member Roles

    This topic provides instructions on how to:

    • Change folder member role
    • Change folder level project member role
    • Change legacy project member role

    Difference between folder-level and legacy projects:

    • Folder-level project: This is a new type of project supported in Fusion that allows access at the folder level. For example, in Project A (a folder-level project), Folder A can be given access to one person, while Folder B can be provided to another.
    • Legacy project: In a legacy project, access is granted at the project level. If a person has access to a legacy project, they will have access to all the folders within that project.

    You will use the following queries in this topic:

    TypeOperationDescription
    Query changeFolderMemberRole Changes the role of a folder member.
    Query changeFolderMemberRole Changes the role of a folder level project member.
    Query changeFolderMemberRole Changes the role of a legacy project member.

    Step 1 - Change Folder Member Role

    The following steps demonstrate how you can run the changeFolderMemberRole query to change folder member role.

    1. Enter the following query in the Query Pane of the Manufacturing Data Model Explorer.

      Query

      mutation changeFolderMemberRole($input: ChangeFolderMemberRoleInput!) {
        changeFolderMemberRole(input: $input) {
            folder {
                id
               }
            }
         }
      
    2. In the Query Variables Pane, enter the following values:

      • emailAddress: The email address of the member whose role you want to change.
      • projectId: The ID of the project that contains the folder where you want to change the member’s role. To know how to obtain the projectId , refer to Retrieve Projects.
      • folderId: The ID of the specific folder where you want to change the member’s role. To know how to obtain the folderId, refer to Retrieve Folders.
      • memberRole: The new role you want to assign to the member. For information on the types of roles that can be assigned, refer to Hub Member Role.

      Query Variables

      {
        "input":{
            "emailAddress": "user1@yopmail.com",
            "projectId": "urn:adsk.workspace:beta.project:ba71aff7-f66e-4958-b0fd-d127a3a96ad0",
            "folderId": "urn:adsk.wipstg:fs.folder:co.Kin7r1PQTN2pmN2x8fCMaA",
            "memberRole" : "EDITOR"
           }
        }
      
      Show More
    3. Click Play. All the members with the specified email addresses will be added to the hub.

      Response

      {
        "data": {
            "changeFolderMemberRole": {
                "folder": {
                    "id": "urn:adsk.wipstg:fs.folder:co.Kin7r1PQTN2pmN2x8fCMaA"
                  }
               }
            }
        }
      
      Show More

    Step 2 - Change Folder Level Project Member Role

    The following steps demonstrate how you can run the changeFolderLevelProjectMemberRole query to change the role of the folder level project member.

    1. Enter the following query in the Query Pane of the Manufacturing Data Model Explorer.

      Query

      mutation changeFolderLevelProjectMemberRole($input: ChangeFolderLevelProjectMemberRoleInput!) {
        changeFolderLevelProjectMemberRole(input: $input) {
            project {
                id
              }
            }
          }
      
    2. In the Query Variables Pane, enter the following values:

      • emailAddress: The email address of the member whose role you want to change.
      • projectId: The ID of the project that contains the folder where you want to change the member’s role. To know how to obtain the projectId , refer to Retrieve Projects.
      • memberRole: The new role you want to assign to the member. For information on the types of roles that can be assigned, refer to Hub Member Role.

      Query Variables

      {
        "input":{
            "emailAddress": "user1@yopmail.com",
            "projectId": "urn:adsk.workspace:beta.project:ba71aff7-f66e-4958-b0fd-d127a3a96ad0",
            "memberRole" : "EDITOR"
          }
      }
      
    3. Click Play. All the members with the specified email addresses will be added to the hub.

      Response

      {
        "data": {
            "changeFolderLevelProjectMemberRole": {
                "project": {
                    "id": "urn:adsk.workspace:beta.project:ba71aff7-f66e-4958-b0fd-d127a3a96ad0"
                }
            }
        }
      }
      
      Show More

    Step 3 - Change Legacy Project Member Role

    The following steps demonstrate how you can run the changeLegacyProjectMemberRole query to change role of the legacy project member.

    1. Enter the following query in the Query Pane of the Manufacturing Data Model Explorer.

      Query

      mutation ChangeLegacyProjectMemberRole($input: ChangeLegacyProjectMemberRoleInput!) {
        changeLegacyProjectMemberRole(input: $input) {
            member {
                project {
                    id
                    name
                }
                role
                user {
                    id
                   }
                  }
                 }
                }
               }
              }
      
      Show More
    2. In the Query Variables Pane, enter the following values:

      • emailAddress: The email address of the member whose role you want to change.
      • projectId: The ID of the project that contains the folder where you want to change the member’s role. To know how to obtain the projectId , refer to Retrieve Projects.
      • memberRole: The new role you want to assign to the member. For information on the types of roles that can be assigned, refer to Hub Member Role.

      Query Variables

      {
        "input": {
          "emailAddress": "hubuser@yopmail.com",
          "projectId": "urn:adsk.workspace:beta.project:a69a9462-c5a1-4525-927a-e6d088573529",
          "role": "EDITOR"
        }
        }
      
    3. Click Play. All the members with the specified email addresses will be added to the hub.

      Response

      {
        "data": {
            "changeLegacyProjectMemberRole": {
                "member": {
                    "project": {
                        "id": "urn:adsk.workspace:beta.project:a69a9462-c5a1-4525-927a-e6d088573529",
                        "name": "FT_DOCS_PROJECT_STG"
                    },
                    "role": "EDITOR",
                    "user": {
                        "id": "4DZ2FF5SM7YEXGE2"
                      }
                    }
                  }
                }
              }
      
      Show More