We've moved!
You can find our new documentation site and support forum for posting questions here.

BUG: deleteWorkspace API status code does not match documentation.

dheimandheiman Member, Broadie ✭✭

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, Administrator, Broadie, Moderator admin

    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 admin

    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 admin

    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:

    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 admin

    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.