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:
Type | Operation | Description |
---|---|---|
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.
- Enter the following query in the Query Pane of the Manufacturing Data Model Explorer.
Query
mutation changeFolderMemberRole($input: ChangeFolderMemberRoleInput!) { changeFolderMemberRole(input: $input) { folder { id } } }
- 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 - 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.
- Enter the following query in the Query Pane of the Manufacturing Data Model Explorer.
Query
mutation changeFolderLevelProjectMemberRole($input: ChangeFolderLevelProjectMemberRoleInput!) { changeFolderLevelProjectMemberRole(input: $input) { project { id } } }
- 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" } }
- 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.
- 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 - 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" } }
- 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