FireCloud is now powered by Terra! -- STARTING MAY 1st, 2019 THIS WEBPAGE WILL NO LONGER BE UPDATED.
From now on, please visit the Terra Help Center for documentation, tutorials, roadmap and feature announcements.
Want to talk to a human? Email the helpdesk, post feature requests or chat with peers in the community forum.

Upcoming FireCloud API Changes

We are planning to make a few changes to our APIs, which are outlined below. If you do not use the FireCloud APIs, or call only the Swagger UI ( your work will not be affected and you do not need to read any further. If you do use the APIs, please keep reading, as these changes may break some of your API calls if you do not modify them accordingly.

Here’s the detail:

  • What: We are making changes to these APIs. The list describes the API changes and what modifications you will need to make to your own code if you are currently calling these APIs. If you do not make the relevant modifications to your API calls, they will fail once the changes are in place. You can make the changes in advance.
  • When: The changes will go into effect on January 3rd, 2019
  • Who: Only users who call the above APIs are affected; the changes will have no other impact on your work or overall experience.
  • Why: We have been working on a new identity access management (IAM) service that allows for increased flexibility in permissions and sharing across all of our back-end services as well as front-end applications. We need to make the API changes listed above in order to roll out the new service.

We are happy to schedule separate conversations with you if you would like further detail or assistance to determine what modifications make sense for your specific project. Please email

dheiman on 28 Nov 2018

@Ilyana_Rosenberg, it would be great if you could list or link the changes in your **What** section (it looks like that may have been your original intent?).

Ilyana_Rosenberg on 28 Nov 2018

Thanks @dheiman. Added link and attached to this comment for reference.

breardon on 28 Nov 2018

With endpoints related to user groups being removed, does that mean that "groups" on FireCloud will be deprecated?

Ilyana_Rosenberg on 28 Nov 2018

@breardon No, groups are not deprecated. They have been moved to the new back-end service. You should not experience any impact.

Ilyana_Rosenberg on 28 Nov 2018

Update: The changes to the FireCloud APIs have been postponed as we continue to ensure minimal user impact prior to release. I will update this Forum post with additional details on a new date for when these changes will occur once we have them.

Ilyana_Rosenberg on 28 Nov 2018

Update: The FireCloud API changes mentioned above will be released to production on Wednesday (12/19) at 4PM EST. There will be downtime from 4PM - 8PM EST during this release.

Tiffany_at_Broad on 28 Nov 2018

Update: The release will go out today January 3rd, 2019.

- Recent posts

- Follow us on Twitter



RT @TerraBioApp: Terra #OpenScience Contest -- You be the judge! Over the past month we ran a contest in which four teams created workspace…
26 Jun 19
FireCloud project resources are affected by this GCP outage as well.
2 Jun 19
RT @jklemm: Also available on @BroadFireCloud where it was leveraged to process all of the RNA-Seq data from TCGA and GTEx through STAR-fus…
29 May 19
RT @TerraBioApp: Do you have a pet workflow or a favorite notebook? Have you thought about sharing them with the world, but keep pushing it…
18 May 19
RT @jklemm: Great meeting this week with #NCICloud and Data Commons Framework teams discussing cancer research priorities for #NCICommons.…
15 May 19

- Our favorite tweets from others

See the theme? Green!
24 Jul 19
I will be introducing Terra to aspiring bioinformatics researchers later this month. I discovered FireCloud (predec…
2 May 19
Pipelines API is used by a number of popular tools, such as Firecloud/Terra from @broadinstitute. @BroadFireCloud
11 Apr 19
The macaque genome isn't finished so it has over 200K contigs. I call them the Rhesus pieces.
15 Mar 19

See more of our favorite tweets...