Troubleshooting "Insufficient Resource Permissions" when uploading runs with BaseSpace CLI

Background

Previous versions of the BaseSpace CLI (1.2.0 and below) application lack permissions (scopes) to upload (create) runs when authenticating. Running the command below without the proper permissions will result in the error message that follows:

$ bs upload run -n Test -t NextSeq ERROR: BASESPACE.COMMON.INSUFFICIENT_RESOURCE_PERMISSIONS: Sorry but this requires CREATERUN access to this resource.

Solution:

To add the proper scope, use the the bs auth command along with the --force option to re-authenticate and overwrite the existing config file. Be sure to include all existing scopes as well. The set of commands will help with printing existing scopes and adding the new scope:

$ bs auth --force --scopes "READ GLOBAL, CREATE GLOBAL, BROWSE GLOBAL, CREATE PROJECTS, START APPLICATIONS, MOVETOTRASH GLOBAL, WRITE GLOBAL, CREATE RUNS"

Note: Even though the error message displays "CREATERUN" permission, the correct scope is "CREATE RUNS".

After adding the necessary scope for uploading runs, the list of scopes should look like this list:

For any feedback or questions regarding this article (Illumina Knowledge Article #3377), contact Illumina Technical Support [email protected].