Use API_ChangeUserRole to assign a user to a new role, to upgrade or downgrade access, or simply to move the user to a different role.
You can also use this call to assign the user to a special role called None (role id 9) which removes the user's access to the application. Use the None role if you want to disable access while retaining the user on the application user list.
To assign roles to users using the Quick Base API or UI, you must have either Basic Access with Sharing access or Full Administration access to the application. Note that, if you have Basic Access with Sharing permissions, you cannot add a user to a role that has Full Administration permissions.
The user ID. You can use API_GetUserInfo to get the user ID for a particular user.
The user’s current role in the application
If this parameter is not supplied, or is supplied but left blank, the role id is set to 9 (None). If this parameter is supplied with an invalid role id (including 0), the API call will return an error.
Note: If you change one user role to 9, and the user has another role in this app, the other role is still active. The user will still have the access given by that other role.
a ticket - needed for application access.
yes, one of:
The user token is an alternative means of authentication, used for API access. User tokens cannot be used to access the Quick Base UI.
yes, one of:
Supply a valid application token.
yes, if app tokens are being used by this application.
A string value that you want returned. It will not be handled by Quick Base but it will be returned in the response. One possible use is to maintain state in the calling application.
Echoes the originating request, for example, API_AddField.
If successful, this will be 0. If there is a failure, there will be a code returned here. See Appendix A for a list of codes.
If successful, this will be “No error”. If there is a failure this contains more detail on the nature of the failure.
Optional. Contains any udata value supplied in the request.
where target_domain is the domain against which you are invoking this call, for example, quickbase.com. Read about this notation.
<?xml version="1.0" ?>
© 1999-2019 QuickBase, Inc. All rights reserved. Legal Notices.