Update user role and site assignment
Organization
Update user role and site assignment
Modify an existing user’s role and site assignments within the organization.
Updatable Permissions:
- Organizational role (Owner, Manager, Collector, Viewer)
- Site assignments and access scope
- Tags for user categorization within the organization
- Specific permission overrides
Role Change Impact:
- Owner: Can only be changed by other owners, affects billing access
- Manager: Changes site management capabilities and user permissions
- Collector: Affects data entry permissions across forms and sites
- Viewer: Modifies read-only access scope and reporting capabilities
Site Assignment Changes:
- Adding sites grants access to related forms and data
- Removing sites revokes access and hides related information
- Hierarchical changes affect child site access automatically
- Changes are applied immediately for active sessions
Security Considerations:
- Cannot modify users with higher or equal permissions
- Audit trail maintained for all role changes
- Immediate session updates for security-sensitive changes
- Prevents accidental privilege escalation
Requires site manager permissions and appropriate scope to modify the target user’s access.
PATCH
Update user role and site assignment
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Body
application/json

