Change a user role
Moves one user of an app to another role.
PATCH https://cotlet.dev/api/v1/quickbase/user-role
write Confirm
Uses Change Role on the Users page: it selects the user by email and sets the new role. The user's access to the app changes at once, and the answer returns the previous role so you can switch back. Needs an App Admin or App Manager role, or the 'Manage users and share the app' permission. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| app string required | string | App name as it appears under My apps, e.g. 'Field Ops'. |
| email string required | string | Email address of the user, as list_users shows it. |
| role string required | string | New role name. It must exist in the app. |
Request
curl -X PATCH https://cotlet.dev/api/v1/quickbase/user-role \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"app":"Field Ops","email":"jane@example.com","role":"role"}'result = client.call("quickbase", "change_user_role", {"app":"Field Ops","email":"jane@example.com","role":"role"})const result = await cotlet.call('quickbase', 'change_user_role', {"app":"Field Ops","email":"jane@example.com","role":"role"});cotlet call quickbase change_user_role --data '{"app":"Field Ops","email":"jane@example.com","role":"role"}'Example response
{
"app": "Field Ops",
"email": "sam@example.com",
"previous_role": "Technician",
"role": "Viewer"
}