Groups API calls not linked to web interface functionality?

nrashinrashi DC - District of ColumbiaMember


I've been trying to use the newly released feature below from the release notes here -

You can now use the FireCloud APIs to create and manage groups of users! Groups can be used to easily manage permissions on workspaces and billing projects. For example, you can maintain a group with all members of your lab and give that entire group access to a workspace. Previously, you would have needed to add each lab member individually. The API command for this feature can be accessed under the "Groups" section on Once you have created a group using the API, you will be able to make use of the group through the web interface in relevant areas such as the workspace sharing dialog.

As the release notes say, that the user would be able to make use of the groups created via API on the web interface using the sharing dialogue feature in workspaces; although the API functionality works in pieces, but I'm not sure how to access these newly created groups from workspaces or billing management to be able to add or remove a group using web interface. I could not find any feature when I navigate to a workspace, and click on the blue sharing link to be able to add a group there. I was also not able to access these groups while being the owner of a billing group as well.

Is there any documentation available related to this API functionality and how different access permissions work with it?




  • Tiffany_at_BroadTiffany_at_Broad Cambridge, MAMember, Administrator, Broadie, Moderator admin

    Hi Rashi,
    Thanks for writing! Sorry for the confusion around Group management. In the next few weeks, we will be introducing this in the web interface along with documentation, so it should be simpler to manage.

    Assuming you know the name of the Group
    1. To share a workspace with a Group, click "Sharing...", and add: [email protected]
    2. To share a billing project with a Group, click "Add user...", and enter: [email protected]
    If you give the Group "user" access to the billing project, the people in that Group should be able to use that billing project.

    To get the Group name using the APIs, go here and check the response for the "usersGroupEmail"

    What is the "billing group" you mentioned and what was the API's response when you tried to access?
    Let me know if this helps!

  • Tiffany_at_BroadTiffany_at_Broad Cambridge, MAMember, Administrator, Broadie, Moderator admin

    Hi @nrashi ! FYI, you can manage Groups in the web interface now. We wrote this to help.

  • nrashinrashi DC - District of ColumbiaMember

    Hi @Tiffany_at_Broad ! Thanks for all the detailed information on Groups API and the linking with the web interface. Will check it out soon!

Sign In or Register to comment.