REST endpoints in 8.18 and 8.19 API docs inadvertently marked as deprecated

XMLWordPrintable

    • 2
    • Severity 3 - Minor
    • 8
    • CtB - Improve Existing

      Issue Summary

      A large number of the REST API endpoints are marked as deprecated in the Bitbucket 8.18 REST API documentation: https://developer.atlassian.com/server/bitbucket/rest/v818

      I suspect this has occurred because the RestResource base class has been marked as deprecated. However this Java class deprecation shouldn't translate to actual REST endpoint deprecation.

      Steps to Reproduce

      View the REST API documentation, for example: https://developer.atlassian.com/server/bitbucket/rest/v818/api-group-authentication/#api-access-tokens-latest-projects-projectkey-get

      Expected Results

      I believe only those REST endpoints documented with the Swagger annotation @Tag(name = "Deprecated") are meant to be documented as deprecated.

      Actual Results

      A large number of REST endpoints are unintentionally marked as deprecated.

      Workaround

      Refer to the Bitbucket 8.17 REST API documentation, it is an accurate reflection of what is and isn't deprecated. I don't believe there is an additional REST API deprecated in Bitbucket 8.18.

              Assignee:
              Stanley Su
              Reporter:
              Ben Humphreys
              Votes:
              1 Vote for this issue
              Watchers:
              6 Start watching this issue

                Created:
                Updated:
                Resolved: