Update Project User Role
Update a user’s role on a project.
Works for both full users and stub users.
Requirements:
- Requires FULL_ACCESS on the project
- Cannot update project role for workspace owners
- Role must be a valid project role: full_access, editor, commenter, downloader, viewer, no_access
Note: For MEMBER_LIMITED users, setting NO_ACCESS removes their explicit permission (equivalent to DELETE) since they have no access without explicit permission.
Authorizations
JWT in Authorization header. 'Bearer ' prefix optional.
Body
API request schema for updating a user's role on a project.
Note: For MEMBER users, NO_ACCESS blocks their default project access. For MEMBER_LIMITED users, setting NO_ACCESS removes their explicit permission (equivalent to removing them from the project) since they have no access without it.
New role for the user (must be a project role: full_access, editor, commenter, downloader, viewer, no_access). Note: For MEMBER_LIMITED users, if the role is set to no_access and this is the user's last project with access in the workspace, the user will be removed from the workspace.
owner, member, member_limited, full_access, editor, commenter, downloader, viewer, no_access Response
Successful Response
API response schema for a user with project access.
User ID
User's first name
User's last name
User's email address
User's effective role on this project
owner, member, member_limited, full_access, editor, commenter, downloader, viewer, no_access Permission bitmap derived from role
User's workspace role (for determining editability)
owner, member, member_limited, full_access, editor, commenter, downloader, viewer, no_access True if user has explicit permission on this project
User's avatar URL
External user ID from auth provider (None for stub users)

