To celebrate the release of GATK 4.0, we are giving away free credits for running the GATK4 Best Practices pipelines in FireCloud, our secure online analysis portal. It’s first come first serve, so sign up now to claim your free credits worth $250. Sponsored by Google Cloud. Learn more at
LATEST RELEASE: FireCloud's latest release was on February 13th. Release Notes can be found here.

BUG: deleteWorkspace API status code does not match documentation.

According to the swagger documentation, the deleteWorkspace API is supposed to return status code 202 on success/command acceptance, but instead it returns a 200.



  • Tiffany_at_BroadTiffany_at_Broad Cambridge, MAMember, Broadie, Moderator

    Thanks for letting us know! I have raised a ticket for this to be updated.

  • dheimandheiman Member, Broadie

    Any more on this? It looks like the docs were updated for some of the other workspace APIs to include 200 No response was specified, which I think may be a bug as well since 200 is supposed to mean a generic OK. Looking across the internet, I suspect that its presence is due to being part of the swagger YAML template, and was not deleted/modified before posting the swagger documentation.

  • KateNKateN Cambridge, MAMember, Broadie, Moderator

    I will check on the status of your original request and get back to you.

    Do you know which APIs have the incorrect 200 return code in the documentation? I am unable to find it with my initial inspection.

  • KateNKateN Cambridge, MAMember, Broadie, Moderator

    It appears that this bug has been assigned to a team, but due to other high-priority work, it has not yet been worked on. Is this documentation inaccuracy blocking your work in any way?

  • dheimandheiman Member, Broadie

    These are 3 APIs that I know of with the incorrect 200 return code:
    PUT /api/workspaces/{workspaceNamespace}/{workspaceName}/lock
    PUT /api/workspaces/{workspaceNamespace}/{workspaceName}/unlock

    This blocks some of our work on FISS. Part of what we want to do is automated code generation based on the swagger documentation in the same way we do for FireBrowse. Inaccurate swagger documentation keeps that vision from becoming a reality, and we are forced to continually retrofit our code based on testing the API for what the actual "truth" is.

  • KateNKateN Cambridge, MAMember, Broadie, Moderator

    I see, that is definitely an issue. I've asked the ticket to be reprioritized and added your notes about the additional 3 APIs.

Sign In or Register to comment.